--- title: "PATCH /applications/{application_id}" method: PATCH path: "/applications/{application_id}" --- # PATCH /applications/{application_id} `PATCH /applications/{application_id}` ## Request body - ApplicationFormPartial - `description` object, nullable - `default` string, required - `localizations` object, nullable - `icon` string, byte, nullable - `cover_image` string, byte, nullable - `team_id` string, snowflake - `flags` integer, nullable - `interactions_endpoint_url` string, uri, nullable - `explicit_content_filter` union - 0 — inherit guild content filter setting - 1 — interactions will always be scanned - `max_participants` integer, nullable - `type` 4 - `tags` string[], nullable - `custom_install_url` string, uri, nullable - `install_params` ApplicationOAuth2InstallParams - `scopes` OAuth2Scopes[], nullable - union - 'identify' — allows /users/@me without email - 'email' — enables /users/@me to return an email - 'connections' — allows /users/@me/connections to return linked third-party accounts - 'guilds' — allows /users/@me/guilds to return basic information about all of a user's guilds - 'guilds.join' — allows /guilds/{guild.id}/members/{user.id} to be used for joining users to a guild - 'guilds.members.read' — allows /users/@me/guilds/{guild.id}/member to return a user's member information in a guild - 'gdm.join' — allows your app to join users to a group dm - 'bot' — for oauth2 bots, this puts the bot in the user's selected guild by default - 'rpc' — for local rpc server access, this allows you to control a user's local Discord client - requires Discord approval - 'rpc.notifications.read' — for local rpc server access, this allows you to receive notifications pushed out to the user - requires Discord approval - 'rpc.voice.read' — for local rpc server access, this allows you to read a user's voice settings and listen for voice events - requires Discord approval - 'rpc.voice.write' — for local rpc server access, this allows you to update a user's voice settings - requires Discord approval - 'rpc.video.read' — for local rpc server access, this allows you to read a user's video status - requires Discord approval - 'rpc.video.write' — for local rpc server access, this allows you to update a user's video settings - requires Discord approval - 'rpc.screenshare.read' — for local rpc server access, this allows you to read a user's screenshare status- requires Discord approval - 'rpc.screenshare.write' — for local rpc server access, this allows you to update a user's screenshare settings- requires Discord approval - 'rpc.activities.write' — for local rpc server access, this allows you to update a user's activity - requires Discord approval - 'webhook.incoming' — this generates a webhook that is returned in the oauth token response for authorization code grants - 'messages.read' — for local rpc server api access, this allows you to read messages from all client channels (otherwise restricted to channels/guilds your app creates) - 'applications.builds.upload' — allows your app to upload/update builds for a user's applications - requires Discord approval - 'applications.builds.read' — allows your app to read build data for a user's applications - 'applications.commands' — allows your app to use commands in a guild - 'applications.commands.permissions.update' — allows your app to update permissions for its commands in a guild a user has permissions to - 'applications.commands.update' — allows your app to update its commands using a Bearer token - client credentials grant only - 'applications.store.update' — allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications - 'applications.entitlements' — allows your app to read entitlements for a user's applications - 'activities.read' — allows your app to fetch data from a user's "Now Playing/Recently Played" list - requires Discord approval - 'activities.write' — allows your app to update a user's activity - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER) - 'activities.invites.write' — allows your app to send activity invites - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER) - 'relationships.read' — allows your app to know a user's friends and implicit relationships - requires Discord approval - 'voice' — allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval - 'dm_channels.read' — allows your app to see information about the user's DMs and group DMs - requires Discord approval - 'role_connections.write' — allows your app to update a user's connection and metadata for the app - 'openid' — for OpenID Connect, this allows your app to receive user id and basic profile information - `permissions` integer, nullable - `role_connections_verification_url` string, uri, nullable - `integration_types_config` object, nullable ## Response `200` 200 response for update_application - PrivateApplicationResponse - `id` string, snowflake, required - `name` string, required - `icon` string, nullable - `description` string, required - `type` 4 - `cover_image` string - `primary_sku_id` string, snowflake - `bot` UserResponse - `id` string, snowflake, required - `username` string, required - `avatar` string, nullable - `discriminator` string, required - `public_flags` integer, required - `flags` integer, required - `bot` boolean - `system` boolean - `banner` string, nullable - `accent_color` integer, nullable - `global_name` string, nullable - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required - `sku_id` string, snowflake - `collectibles` UserCollectiblesResponse - `nameplate` UserNameplateResponse — unresolved $ref - `primary_guild` UserPrimaryGuildResponse - `identity_guild_id` string, snowflake - `identity_enabled` boolean, nullable - `tag` string, nullable - `badge` string, nullable - `slug` string - `guild_id` string, snowflake - `rpc_origins` string[] - `bot_public` boolean - `bot_require_code_grant` boolean - `terms_of_service_url` string, uri - `privacy_policy_url` string, uri - `custom_install_url` string, uri - `install_params` ApplicationOAuth2InstallParamsResponse - `scopes` OAuth2Scopes[], required - union - 'identify' — allows /users/@me without email - 'email' — enables /users/@me to return an email - 'connections' — allows /users/@me/connections to return linked third-party accounts - 'guilds' — allows /users/@me/guilds to return basic information about all of a user's guilds - 'guilds.join' — allows /guilds/{guild.id}/members/{user.id} to be used for joining users to a guild - 'guilds.members.read' — allows /users/@me/guilds/{guild.id}/member to return a user's member information in a guild - 'gdm.join' — allows your app to join users to a group dm - 'bot' — for oauth2 bots, this puts the bot in the user's selected guild by default - 'rpc' — for local rpc server access, this allows you to control a user's local Discord client - requires Discord approval - 'rpc.notifications.read' — for local rpc server access, this allows you to receive notifications pushed out to the user - requires Discord approval - 'rpc.voice.read' — for local rpc server access, this allows you to read a user's voice settings and listen for voice events - requires Discord approval - 'rpc.voice.write' — for local rpc server access, this allows you to update a user's voice settings - requires Discord approval - 'rpc.video.read' — for local rpc server access, this allows you to read a user's video status - requires Discord approval - 'rpc.video.write' — for local rpc server access, this allows you to update a user's video settings - requires Discord approval - 'rpc.screenshare.read' — for local rpc server access, this allows you to read a user's screenshare status- requires Discord approval - 'rpc.screenshare.write' — for local rpc server access, this allows you to update a user's screenshare settings- requires Discord approval - 'rpc.activities.write' — for local rpc server access, this allows you to update a user's activity - requires Discord approval - 'webhook.incoming' — this generates a webhook that is returned in the oauth token response for authorization code grants - 'messages.read' — for local rpc server api access, this allows you to read messages from all client channels (otherwise restricted to channels/guilds your app creates) - 'applications.builds.upload' — allows your app to upload/update builds for a user's applications - requires Discord approval - 'applications.builds.read' — allows your app to read build data for a user's applications - 'applications.commands' — allows your app to use commands in a guild - 'applications.commands.permissions.update' — allows your app to update permissions for its commands in a guild a user has permissions to - 'applications.commands.update' — allows your app to update its commands using a Bearer token - client credentials grant only - 'applications.store.update' — allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications - 'applications.entitlements' — allows your app to read entitlements for a user's applications - 'activities.read' — allows your app to fetch data from a user's "Now Playing/Recently Played" list - requires Discord approval - 'activities.write' — allows your app to update a user's activity - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER) - 'activities.invites.write' — allows your app to send activity invites - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER) - 'relationships.read' — allows your app to know a user's friends and implicit relationships - requires Discord approval - 'voice' — allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval - 'dm_channels.read' — allows your app to see information about the user's DMs and group DMs - requires Discord approval - 'role_connections.write' — allows your app to update a user's connection and metadata for the app - 'openid' — for OpenID Connect, this allows your app to receive user id and basic profile information - `permissions` string, required - `integration_types_config` object - `verify_key` string, required - `flags` integer, required - `max_participants` integer, nullable - `tags` string[] - `redirect_uris` string[], required - `interactions_endpoint_url` string, uri, nullable - `role_connections_verification_url` string, uri, nullable - `owner` UserResponse, required - `id` string, snowflake, required - `username` string, required - `avatar` string, nullable - `discriminator` string, required - `public_flags` integer, required - `flags` integer, required - `bot` boolean - `system` boolean - `banner` string, nullable - `accent_color` integer, nullable - `global_name` string, nullable - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required - `sku_id` string, snowflake - `collectibles` UserCollectiblesResponse - `nameplate` UserNameplateResponse — unresolved $ref - `primary_guild` UserPrimaryGuildResponse - `identity_guild_id` string, snowflake - `identity_enabled` boolean, nullable - `tag` string, nullable - `badge` string, nullable - `approximate_guild_count` integer, nullable - `approximate_user_install_count` integer, required - `approximate_user_authorization_count` integer, required - `explicit_content_filter` union, required - 0 — inherit guild content filter setting - 1 — interactions will always be scanned - `team` TeamResponse - `id` string, snowflake, required - `icon` string, nullable - `name` string, required - `owner_user_id` string, snowflake, required - `members` TeamMemberResponse[], required - `user` UserResponse, required - `id` string, snowflake, required - `username` string, required - `avatar` string, nullable - `discriminator` string, required - `public_flags` integer, required - `flags` integer, required - `bot` boolean - `system` boolean - `banner` string, nullable - `accent_color` integer, nullable - `global_name` string, nullable - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required - `sku_id` string, snowflake - `collectibles` UserCollectiblesResponse - `nameplate` UserNameplateResponse — unresolved $ref - `primary_guild` UserPrimaryGuildResponse - `identity_guild_id` string, snowflake - `identity_enabled` boolean, nullable - `tag` string, nullable - `badge` string, nullable - `team_id` string, snowflake, required - `membership_state` union, required - 1 — User has been invited to the team. - 2 — User has accepted the team invitation. ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response --- [API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/e4fdf8b45809/schema)