--- title: "PUT /applications/{application_id}/commands" method: PUT path: "/applications/{application_id}/commands" --- # PUT /applications/{application_id}/commands `PUT /applications/{application_id}/commands` ## Request body - ApplicationCommandUpdateRequest[], nullable - `name` string, required - `name_localizations` object, nullable - `description` string, nullable - `description_localizations` object, nullable - `options` union[], nullable - union - ApplicationCommandAttachmentOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - `file_types` string[], nullable - ApplicationCommandBooleanOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - ApplicationCommandChannelOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - `channel_types` ChannelTypes[], nullable - union - 1 — A direct message between users - 3 — A direct message between multiple users - 0 — A text channel within a server - 2 — A voice channel within a server - 4 — An organizational category that contains up to 50 channels - 5 — A channel that users can follow and crosspost into their own server (formerly news channels) - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission - 13 — A voice channel for hosting events with an audience - 14 — The channel in a hub containing the listed servers - 15 — Channel that can only contain threads - ApplicationCommandIntegerOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - `autocomplete` boolean, nullable - `choices` ApplicationCommandOptionIntegerChoice[], nullable - `name` string, required - `name_localizations` object, nullable - `value` integer, required - `min_value` integer - `max_value` integer - ApplicationCommandMentionableOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - ApplicationCommandNumberOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - `autocomplete` boolean, nullable - `choices` ApplicationCommandOptionNumberChoice[], nullable - `name` string, required - `name_localizations` object, nullable - `value` number, double, required - `min_value` number, double, nullable - `max_value` number, double, nullable - ApplicationCommandRoleOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - ApplicationCommandStringOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - `autocomplete` boolean, nullable - `min_length` integer, nullable - `max_length` integer, nullable - `choices` ApplicationCommandOptionStringChoice[], nullable - `name` string, required - `name_localizations` object, nullable - `value` string, required - ApplicationCommandSubcommandGroupOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - `options` ApplicationCommandSubcommandOption[], nullable - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - `options` union[], nullable - union - … - ApplicationCommandSubcommandOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - `options` union[], nullable - union - ApplicationCommandAttachmentOption - … - ApplicationCommandBooleanOption - … - ApplicationCommandChannelOption - … - ApplicationCommandIntegerOption - … - ApplicationCommandMentionableOption - … - ApplicationCommandNumberOption - … - ApplicationCommandRoleOption - … - ApplicationCommandStringOption - … - ApplicationCommandUserOption - … - ApplicationCommandUserOption - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localizations` object, nullable - `description` string, required - `description_localizations` object, nullable - `required` boolean, nullable - `default_member_permissions` integer, nullable - `dm_permission` boolean, nullable - `contexts` InteractionContextType[], nullable - union - 0 — This command can be used within a Guild. - 1 — This command can be used within a DM with this application's bot. - 2 — This command can be used within DMs and Group DMs with users. - `integration_types` ApplicationIntegrationType[], nullable - union - 0 — For Guild install. - 1 — For User install. - `handler` union - 1 — The app handles the interaction using an interaction token - 2 — Discord handles the interaction by launching an Activity and sending a follow-up message without coordinating with the app - `type` union - 1 — Slash commands; a text-based command that shows up when a user types / - 2 — A UI-based command that shows up when you right click or tap on a user - 3 — A UI-based command that shows up when you right click or tap on a message - 4 — A command that represents the primary way to use an application (e.g. launching an Activity) - `id` string, snowflake ## Response `200` 200 response for bulk_set_application_commands - ApplicationCommandResponse[], nullable - `id` string, snowflake, required - `application_id` string, snowflake, required - `version` string, snowflake, required - `default_member_permissions` string, nullable, required - `type` union, required - 1 — Slash commands; a text-based command that shows up when a user types / - 2 — A UI-based command that shows up when you right click or tap on a user - 3 — A UI-based command that shows up when you right click or tap on a message - 4 — A command that represents the primary way to use an application (e.g. launching an Activity) - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `guild_id` string, snowflake - `dm_permission` boolean - `contexts` InteractionContextType[], nullable - union - 0 — This command can be used within a Guild. - 1 — This command can be used within a DM with this application's bot. - 2 — This command can be used within DMs and Group DMs with users. - `integration_types` ApplicationIntegrationType[] - union - 0 — For Guild install. - 1 — For User install. - `options` union[] - union - ApplicationCommandAttachmentOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `file_types` string[] - ApplicationCommandBooleanOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - ApplicationCommandChannelOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `channel_types` ChannelTypes[] - union - 1 — A direct message between users - 3 — A direct message between multiple users - 0 — A text channel within a server - 2 — A voice channel within a server - 4 — An organizational category that contains up to 50 channels - 5 — A channel that users can follow and crosspost into their own server (formerly news channels) - 10 — A temporary sub-channel within a GUILD_ANNOUNCEMENT channel - 11 — A temporary sub-channel within a GUILD_TEXT or GUILD_THREADS_ONLY channel type set - 12 — A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission - 13 — A voice channel for hosting events with an audience - 14 — The channel in a hub containing the listed servers - 15 — Channel that can only contain threads - ApplicationCommandIntegerOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `autocomplete` boolean - `choices` ApplicationCommandOptionIntegerChoiceResponse[] - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `value` integer, required - `min_value` integer - `max_value` integer - ApplicationCommandMentionableOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - ApplicationCommandNumberOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `autocomplete` boolean - `choices` ApplicationCommandOptionNumberChoiceResponse[] - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `value` number, double, required - `min_value` number, double - `max_value` number, double - ApplicationCommandRoleOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - ApplicationCommandStringOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `autocomplete` boolean - `choices` ApplicationCommandOptionStringChoiceResponse[] - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `value` string, required - `min_length` integer - `max_length` integer - ApplicationCommandSubcommandGroupOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `options` ApplicationCommandSubcommandOptionResponse[] - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `options` union[] - union - … - ApplicationCommandSubcommandOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `options` union[] - union - ApplicationCommandAttachmentOptionResponse - … - ApplicationCommandBooleanOptionResponse - … - ApplicationCommandChannelOptionResponse - … - ApplicationCommandIntegerOptionResponse - … - ApplicationCommandMentionableOptionResponse - … - ApplicationCommandNumberOptionResponse - … - ApplicationCommandRoleOptionResponse - … - ApplicationCommandStringOptionResponse - … - ApplicationCommandUserOptionResponse - … - ApplicationCommandUserOptionResponse - `type` union, required - 1 — A sub-action within a command or group - 2 — A group of subcommands - 3 — A string option - 4 — An integer option. Any integer between -2^53 and 2^53 is a valid value - 5 — A boolean option - 6 — A snowflake option that represents a User - 7 — A snowflake option that represents a Channel. Includes all channel types and categories - 8 — A snowflake option that represents a Role - 9 — A snowflake option that represents anything you can mention - 10 — A number option. Any double between -2^53 and 2^53 is a valid value - 11 — An attachment option - `name` string, required - `name_localized` string - `name_localizations` object, nullable - `description` string, required - `description_localized` string - `description_localizations` object, nullable - `required` boolean - `nsfw` boolean - `handler` union - 1 — The app handles the interaction using an interaction token - 2 — Discord handles the interaction by launching an Activity and sending a follow-up message without coordinating with the app ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response ## Changes - **2026-08-06** `f6cd197cbe47` — 6 info - added the new optional request property `items/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOption]/file_types` - added the new optional request property `items/options/items/oneOf[#/components/schemas/ApplicationCommandSubcommandGroupOption]/options/items/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOption]/file_types` - added the new optional request property `items/options/items/oneOf[#/components/schemas/ApplicationCommandSubcommandOption]/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOption]/file_types` - added the optional property `items/options/items/oneOf[#/components/schemas/ApplicationCommandAttachmentOptionResponse]/file_types` to the response with the `200` status - …2 more - **2026-06-05** `693bf1f99bba` — 2 info - added `subschema #1: APP_HANDLER, subschema #2: DISCORD_LAUNCH_ACTIVITY` to the `items/handler/oneOf[#/components/schemas/ApplicationCommandHandler]/` request property `oneOf` list - added the optional property `items/handler` to the response with the `200` status - **2026-04-03** `ea59bf0ccbe1` — 1 info - the `items/default_member_permissions` request property's max was increased from `9007199254740991.00` to `18014398509481984.00` - **2026-02-04** `e200830e509a` — 1 info - the response property `items/default_member_permissions` became required for the status `200` [Change history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/applications/:application_id/commands/put.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/49efa428e0dd/schema)