--- 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 — unresolved $ref ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response ## Changes - **2026-04-15** `fde18f54cbbd` — 1 breaking - added `subschema #1: ADMIN, subschema #2: DEVELOPER, subschema #3: READ_ONLY` to the `team/oneOf[#/components/schemas/TeamResponse]/members/items/role` response property `oneOf` list for the response status `200` - **2026-04-15** `e2ba79dfc5ba` — 3 info - added the optional property `event_webhooks_status` to the response with the `200` status - added the optional property `event_webhooks_types` to the response with the `200` status - added the optional property `event_webhooks_url` to the response with the `200` status - **2026-04-14** `d0944513f239` — 2 info - added the required property `team/oneOf[#/components/schemas/TeamResponse]/members/items/permissions` to the response with the `200` status - added the required property `team/oneOf[#/components/schemas/TeamResponse]/members/items/role` to the response with the `200` status - **2026-04-03** `ea59bf0ccbe1` — 2 info - the `install_params/oneOf[#/components/schemas/ApplicationOAuth2InstallParams]/permissions` request property's max was increased from `9007199254740991.00` to `18014398509481984.00` - the `integration_types_config/additionalProperties/oneOf[#/components/schemas/ApplicationIntegrationTypeConfiguration]/oauth2_install_params/oneOf[#/components/schemas/ApplicationOAuth2InstallParams]/permissions` request property's max was increased from `9007199254740991.00` to `18014398509481984.00` - …earlier changes not shown [Full history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/applications/:application_id/patch.md) --- [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/fde18f54cbbd/schema)