Skip to content

User and Message Application Commands #3614

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 18 commits into from
Aug 10, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
blank_issues_enabled: false
contact_links:
- name: API, Slash Command, and Message Component Feature Requests
- name: API, Application Command, and Message Component Feature Requests
url: https://github.com/discord/discord-api-docs/discussions
about: Suggestions for new or different behavior in Discord's API, Gateway, OAuth2, SDK, Slash Commands, Message Components, etc.
about: Suggestions for new or different behavior in Discord's API, Gateway, OAuth2, SDK, Application Commands, Message Components, etc.
- name: Developer Documentation
url: https://discord.com/developers/docs
about: Need documentation and examples for the API? Head over to Discord's developer documentation.
Expand Down
24 changes: 16 additions & 8 deletions docs/Change_Log.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# Change Log

## User and Message Commands

#### August 10, 2021

[User commands](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/user-commands) and [message commands](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/message-commands) are now live! These commands appear on context menus for users and messages, with more to come in the future.

Context menu commands are a type of application command. The "Slash Commands" documentation page has been renamed to "Application Commands" and split out by type to show this.

## Select Menu Components

#### June 30, 2021
Expand Down Expand Up @@ -40,21 +48,21 @@ This documentation is being published early so bots can have at least two months
Additionally, API v9 also removes the `/channels/:id/messages/:id/suppress-embeds` route.


## Slash Command Permissions
## Application Command Permissions

#### April 5, 2021

Need to keep some of your Slash Commands safe from prying eyes, or only available to the right people? Slash Commands now support [command permissions](#DOCS_INTERACTIONS_SLASH_COMMANDS/permissions)!
Need to keep some of your commands safe from prying eyes, or only available to the right people? Commands now support [command permissions](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/permissions)!

You can enable or disable a command (guild or global) for a specific user or role in a guild. For now, users will still be able to see the commands, but won't be able to use them.

New routes have been added to support this functionality:

- [`GET Guild Application Command Permissions`](#DOCS_INTERACTIONS_SLASH_COMMANDS/getguildapplicationcommandpermissions)
- [`GET Application Command Permissions`](#DOCS_INTERACTIONS_SLASH_COMMANDS/getapplicationcommandpermissions)
- [`PUT Application Command Permissions`](#DOCS_INTERACTIONS_SLASH_COMMANDS/putapplicationcommandpermissions)
- [`GET Guild Application Command Permissions`](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/getguildapplicationcommandpermissions)
- [`GET Application Command Permissions`](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/getapplicationcommandpermissions)
- [`PUT Application Command Permissions`](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/putapplicationcommandpermissions)

A `default_permission` field has also been added to the [ApplicationCommand](#DOCS_INTERACTIONS_SLASH_COMMANDS/application-command-object-application-command-structure) model. This field allows you to disable commands for everyone in a guild by default, if you prefer to make some of your commands an opt-in experience.
A `default_permission` field has also been added to the [ApplicationCommand](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/application-command-object-application-command-structure) model. This field allows you to disable commands for everyone in a guild by default, if you prefer to make some of your commands an opt-in experience.

## Large Bot Sharding Lowered to 150,000 Guilds

Expand All @@ -66,7 +74,7 @@ There have been reports that sessions have higher frequency of errors when start

#### March 5, 2021

Changes to interaction response types have been made to support better designs for Slash Commands:
Changes to interaction response types have been made to support better designs for application commands:

- Type `2` `Acknowledge` has been deprecated
- Type `3` `ChannelMessage` has been deprecated
Expand All @@ -92,7 +100,7 @@ Permission overwrites in the guild channel creation endpoint are now validated a

#### December 15, 2020

Slash Commands are here! There's a _lot_ to cover, so go check out specific documentation under [Slash Commands](#DOCS_INTERACTIONS_SLASH_COMMANDS/).
Slash Commands are here! There's a _lot_ to cover, so go check out specific documentation under [Slash Commands](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/).

Slash Commands include some new features for webhooks as well:

Expand Down
2 changes: 1 addition & 1 deletion docs/Intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ If you believe you're experiencing a bug with our API or want to report incorrec

Bots and apps are the lifeblood of the Discord development community. They come in all shapes and sizes, from small hobby projects for your server with friends, to huge projects that live in hundreds of thousands of servers. We love seeing the unique, fun, and sometimes downright strange (in a good way) creations that come from our community.

Discord offers an open API to serve requests for both bots and OAuth2 integrations. So whether you’re making your own [`/wumpus` commands](#DOCS_INTERACTIONS_SLASH_COMMANDS/) or looking to [`Log In With Discord`](#DOCS_TOPICS_OAUTH2/), we’ve got you covered.
Discord offers an open API to serve requests for both bots and OAuth2 integrations. So whether you’re making your own [`/wumpus` commands](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/) or looking to [`Log In With Discord`](#DOCS_TOPICS_OAUTH2/), we’ve got you covered.

So go do it! Go! Go [make an app](https://discord.com/developers/applications) and create something awesome.

Expand Down
Loading