Skip to content

Commit 722485f

Browse files
shaydewaelshaydewael
authored
Merge branch 'main' into username-updates
2 parents c75d7ef + dd48c48 commit 722485f

File tree

11 files changed

+905
-119
lines changed

11 files changed

+905
-119
lines changed

‎docs/Intro.md

Lines changed: 0 additions & 48 deletions
This file was deleted.

‎docs/Intro.mdx

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
![Welcome to the Discord Developer Platform](docs-header.svg)
2+
3+
# Welcome to the Discord Developer Platform
4+
5+
The Discord developer platform lets you develop apps to customize and extend Discord for millions of users. A toolkit of [APIs](#DOCS_REFERENCE) and [resources](#DOCS_TOPICS_COMMUNITY_RESOURCES) pair splendidly with a supportive community to help you build bots, integrate 3rd party services, and add Discord support to your game.
6+
7+
<Button href="https://discord.com/developers/docs/getting-started" color="brand">Get Started</Button>
8+
9+
---
10+
11+
## Explore the Platform
12+
13+
#### Engage with Users
14+
15+
Add interactivity to your app with [commands](#DOCS_INTERACTIONS_APPLICATION_COMMANDS) and [message components](#DOCS_INTERACTIONS_MESSAGE_COMPONENTS) to build engaging experiences in the place where users are already hanging out.
16+
17+
#### Customize Servers
18+
19+
Customize Discord servers by using apps to do things like [send messages](#DOCS_RESOURCES_CHANNEL/create-message), modify [channels](#DOCS_RESOURCES_CHANNEL) and [guilds](#DOCS_RESOURCES_GUILD), [integrate with AutoMod](#DOCS_RESOURCES_AUTO_MODERATION), or [connect to voice](#DOCS_TOPICS_VOICE_CONNECTIONS).
20+
21+
Plus, use the [Gateway API](#DOCS_TOPICS_GATEWAY) to respond to [real-time events](#DOCS_TOPICS_GATEWAY_EVENTS/receive-events) happening in a server, like when a reaction is added to a message.
22+
23+
#### Connect Metadata
24+
25+
Link and update metadata to enhance Discord for users. Add [Rich Presence](#DOCS_GAME_SDK_ACTIVITIES) to display live data on users' profiles, or [connection metadata](#DOCS_RESOURCES_APPLICATION_ROLE_CONNECTION_METADATA) to make it easy for admins to create roles using metadata associated with your app.
26+
27+
## Discover Developer Resources
28+
29+
#### Find Tools and Libraries
30+
31+
The Discord developer community has built and maintained a ton of different [libraries and tools](#DOCS_TOPICS_COMMUNITY_RESOURCES/libraries) over the years. No matter your experience level or language of choice, there are resources to speed up and simplify app development for you over on the [Community Resources](#DOCS_TOPICS_COMMUNITY_RESOURCES) page.
32+
33+
You can also check out our [Postman collections](https://www.postman.com/discord-api) to try and test API endpoints.
34+
35+
#### Connect with Support
36+
37+
- Join the [Discord Developers server](https://discord.gg/discord-developers) for support, discussion, and events about the Discord developer platform.
38+
- Explore the [Developer Help Center](https://support-dev.discord.com/hc) to find articles about common topics and questions, or to reach directly out to our developer support team.
39+
- Use our [GitHub](https://github.com/discord/discord-api-docs) to report API bugs, start a discussion about a developer feature request, or suggest an edit to our open source developer documentation.
40+
41+
So go ahead and [build an app](https://discord.com/developers/applications)! We can’t wait to see what you make.
42+
43+
— Discord

‎docs/interactions/Message_Components.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ There are several different types of components; this documentation will outline
66

77
## What is a Component
88

9-
Components are a new field on the [message object](#DOCS_RESOURCES_CHANNEL/message-object), so you can use them whether you're sending messages or responding to a [slash command](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/) or other interaction.
9+
Components are a field on the [message object](#DOCS_RESOURCES_CHANNEL/message-object), so you can use them whether you're sending messages or responding to a [slash command](#DOCS_INTERACTIONS_APPLICATION_COMMANDS/) or other interaction.
1010

1111
The top-level `components` field is an array of [Action Row](#DOCS_INTERACTIONS_MESSAGE_COMPONENTS/action-rows) components.
1212

‎docs/resources/Auto_Moderation.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -71,13 +71,14 @@ Characterizes the type of content which can trigger the rule.
7171
Additional data used to determine whether a rule should be triggered. Different fields are relevant based on the
7272
value of [trigger_type](#DOCS_RESOURCES_AUTO_MODERATION/auto-moderation-rule-object-trigger-types).
7373

74-
| Field | Type | Associated Trigger Types | Description |
75-
| ------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------ | ------------------------------------------------------------------------------------------------ |
76-
| keyword_filter | array of strings * | KEYWORD | substrings which will be searched for in content (Maximum of 1000) |
77-
| regex_patterns | array of strings ** | KEYWORD | regular expression patterns which will be matched against content (Maximum of 10) |
78-
| presets | array of [keyword preset types](#DOCS_RESOURCES_AUTO_MODERATION/auto-moderation-rule-object-keyword-preset-types) | KEYWORD_PRESET | the internally pre-defined wordsets which will be searched for in content |
79-
| allow_list | array of strings *** | KEYWORD, KEYWORD_PRESET | substrings which should not trigger the rule (Maximum of 100 or 1000) |
80-
| mention_total_limit | integer | MENTION_SPAM | total number of unique role and user mentions allowed per message (Maximum of 50) |
74+
| Field | Type | Associated Trigger Types | Description |
75+
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------ | --------------------------------------------------------------------------------- |
76+
| keyword_filter | array of strings * | KEYWORD | substrings which will be searched for in content (Maximum of 1000) |
77+
| regex_patterns | array of strings ** | KEYWORD | regular expression patterns which will be matched against content (Maximum of 10) |
78+
| presets | array of [keyword preset types](#DOCS_RESOURCES_AUTO_MODERATION/auto-moderation-rule-object-keyword-preset-types) | KEYWORD_PRESET | the internally pre-defined wordsets which will be searched for in content |
79+
| allow_list | array of strings *** | KEYWORD, KEYWORD_PRESET | substrings which should not trigger the rule (Maximum of 100 or 1000) |
80+
| mention_total_limit | integer | MENTION_SPAM | total number of unique role and user mentions allowed per message (Maximum of 50) |
81+
| mention_raid_protection_enabled | boolean | MENTION_SPAM | whether to automatically detect mention raids |
8182

8283
\* A keyword can be a phrase which contains multiple words. [Wildcard symbols](#DOCS_RESOURCES_AUTO_MODERATION/auto-moderation-rule-object-keyword-matching-strategies) can be used to customize how each keyword will be matched. Each keyword must be 60 characters or less.
8384

‎docs/resources/Channel.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -915,7 +915,7 @@ Requires the `MANAGE_CHANNELS` permission for the guild. Fires a [Channel Update
915915
| position | ?integer | the position of the channel in the left-hand listing | All |
916916
| topic | ?string | 0-1024 character channel topic (0-4096 characters for `GUILD_FORUM` channels) | Text, Announcement, Forum |
917917
| nsfw | ?boolean | whether the channel is nsfw | Text, Voice, Announcement, Stage, Forum |
918-
| rate_limit_per_user | ?integer | amount of seconds a user has to wait before sending another message (0-21600); bots, as well as users with the permission `manage_messages` or `manage_channel`, are unaffected | Text, Forum |
918+
| rate_limit_per_user | ?integer | amount of seconds a user has to wait before sending another message (0-21600); bots, as well as users with the permission `manage_messages` or `manage_channel`, are unaffected | Text, Voice, Stage, Forum |
919919
| bitrate\* | ?integer | the bitrate (in bits) of the voice or stage channel; min 8000 | Voice, Stage |
920920
| user_limit | ?integer | the user limit of the voice or stage channel, max 99 for voice channels and 10,000 for stage channels (0 refers to no limit) | Voice, Stage |
921921
| permission_overwrites\*\* | ?array of partial [overwrite](#DOCS_RESOURCES_CHANNEL/overwrite-object) objects | channel or category-specific permissions | All |
@@ -1007,7 +1007,7 @@ Files must be attached using a `multipart/form-data` body as described in [Uploa
10071007
- When sending a message with `tts` (text-to-speech) set to `true`, the current user must have the `SEND_TTS_MESSAGES` permission.
10081008
- When creating a message as a reply to another message, the current user must have the `READ_MESSAGE_HISTORY` permission.
10091009
- The referenced message must exist and cannot be a system message.
1010-
- The maximum request size when sending a message is **8MiB**
1010+
- The maximum request size when sending a message is **25 MiB**
10111011
- For the embed object, you can set every field except `type` (it will be `rich` regardless of if you try to set it), `provider`, `video`, and any `height`, `width`, or `proxy_url` values for images.
10121012

10131013
###### JSON/Form Params
@@ -1282,7 +1282,7 @@ Creates a new thread in a forum channel, and sends a message within the created
12821282
- The type of the created thread is `PUBLIC_THREAD`.
12831283
- See [message formatting](#DOCS_REFERENCE/message-formatting) for more information on how to properly format messages.
12841284
- The current user must have the `SEND_MESSAGES` permission (`CREATE_PUBLIC_THREADS` is ignored).
1285-
- The maximum request size when sending a message is **8MiB**.
1285+
- The maximum request size when sending a message is **25 MiB**.
12861286
- For the embed object, you can set every field except `type` (it will be `rich` regardless of if you try to set it), `provider`, `video`, and any `height`, `width`, or `proxy_url` values for images.
12871287
- Examples for file uploads are available in [Uploading Files](#DOCS_REFERENCE/uploading-files).
12881288
- Files must be attached using a `multipart/form-data` body as described in [Uploading Files](#DOCS_REFERENCE/uploading-files).
@@ -1378,10 +1378,10 @@ Returns archived threads in the channel that are public. When called on a `GUILD
13781378

13791379
###### Query String Params
13801380

1381-
| Field | Type | Description |
1382-
| ------- | ----------------- | -------------------------------------------- |
1383-
| before? | ISO8601 timestamp | returns threads before this timestamp |
1384-
| limit? | integer | optional maximum number of threads to return |
1381+
| Field | Type | Description |
1382+
| ------- | ----------------- | ---------------------------------------------- |
1383+
| before? | ISO8601 timestamp | returns threads archived before this timestamp |
1384+
| limit? | integer | optional maximum number of threads to return |
13851385

13861386
###### Response Body
13871387

@@ -1397,10 +1397,10 @@ Returns archived threads in the channel that are of [type](#DOCS_RESOURCES_CHANN
13971397

13981398
###### Query String Params
13991399

1400-
| Field | Type | Description |
1401-
| ------- | ----------------- | -------------------------------------------- |
1402-
| before? | ISO8601 timestamp | returns threads before this timestamp |
1403-
| limit? | integer | optional maximum number of threads to return |
1400+
| Field | Type | Description |
1401+
| ------- | ----------------- | ---------------------------------------------- |
1402+
| before? | ISO8601 timestamp | returns threads archived before this timestamp |
1403+
| limit? | integer | optional maximum number of threads to return |
14041404

14051405
###### Response Body
14061406

0 commit comments

Comments
 (0)