You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/resources/application.mdx
+12-8Lines changed: 12 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -182,8 +182,9 @@ By default, newly-created apps only support installation to guilds.
182
182
183
183
You can update which installation contexts your app supports in your [app's settings](https://discord.com/developers/applications). On the **Installation** page under the **Installation Contexts** section, you can select the installation contexts your app supports.
184
184
185
-
> info
186
-
> If you update your app to support a new installation context, you will need to update your existing [commands](/docs/interactions/application-commands#contexts) if you want them to be supported in the new context. Details are in the [Application Command](/docs/interactions/application-commands#contexts) documentation.
185
+
:::info
186
+
If you update your app to support a new installation context, you will need to update your existing [commands](/docs/interactions/application-commands#contexts) if you want them to be supported in the new context. Details are in the [Application Command](/docs/interactions/application-commands#contexts) documentation.
187
+
:::
187
188
188
189
## Install Links
189
190
@@ -193,8 +194,9 @@ Install links provide an easy way for users to install your app in Discord. If y
193
194
194
195
There are three options when configuring an install link for your app: "Discord Provided Link", "Custom URL", and "None". If you don't configure an install link (by selecting "None"), the "Add App" button will not appear for your app, and your app will not be eligible for the App Directory.
195
196
196
-
> info
197
-
> Note that install links are distinct from OAuth2 flows like the [authorization code grant](/docs/topics/oauth2#authorization-code-grant), which may additionally be required if you need to request user-specific [scopes](/docs/topics/oauth2#shared-resources-oauth2-scopes) like `identify` or `role_connections.write`.
197
+
:::info
198
+
Note that install links are distinct from OAuth2 flows like the [authorization code grant](/docs/topics/oauth2#authorization-code-grant), which may additionally be required if you need to request user-specific [scopes](/docs/topics/oauth2#shared-resources-oauth2-scopes) like `identify` or `role_connections.write`.
Instead, these links will prompt the user for the scopes and bot user permissions configured in your Default Install Settings.
210
212
211
-
> info
212
-
> Discord Provided Links are limited to the `application.commands` and `bot` scopes
213
+
:::info
214
+
Discord Provided Links are limited to the `application.commands` and `bot` scopes
215
+
:::
213
216
214
217
#### Custom URL
215
218
@@ -233,8 +236,9 @@ Returns the [application](/docs/resources/application#application-object) object
233
236
234
237
Edit properties of the app associated with the requesting bot user. Only properties that are passed will be updated. Returns the updated [application](/docs/resources/application#application-object) object on success.
Copy file name to clipboardExpand all lines: docs/resources/webhook.mdx
+33-22Lines changed: 33 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,8 +33,9 @@ Used to represent a webhook.
33
33
34
34
###### Webhook Types
35
35
36
-
> info
37
-
> These types don't include [webhook events](/docs/events/webhook-events), which are outgoing webhooks sent to your app by Discord. See [Webhook Events](/docs/events/webhook-events) for details.
36
+
:::info
37
+
These types don't include [webhook events](/docs/events/webhook-events), which are outgoing webhooks sent to your app by Discord. See [Webhook Events](/docs/events/webhook-events) for details.
@@ -118,8 +119,9 @@ An error will be returned if a webhook name (`name`) is not valid. A webhook nam
118
119
- It does not contain the substrings `clyde` or `discord` (case-insensitive)
119
120
- It follows the nickname guidelines in the [Usernames and Nicknames](/docs/resources/user#usernames-and-nicknames) documentation, with an exception that webhook names can be up to 80 characters
120
121
121
-
> info
122
-
> This endpoint supports the `X-Audit-Log-Reason` header.
122
+
:::info
123
+
This endpoint supports the `X-Audit-Log-Reason` header.
124
+
:::
123
125
124
126
###### JSON Params
125
127
@@ -156,11 +158,13 @@ Same as above, except this call does not require authentication and returns no u
156
158
157
159
Modify a webhook. Requires the `MANAGE_WEBHOOKS` permission. Returns the updated [webhook](/docs/resources/webhook#webhook-object) object on success. Fires a [Webhooks Update](/docs/events/gateway-events#webhooks-update) Gateway event.
158
160
159
-
> info
160
-
> All parameters to this endpoint are optional
161
+
:::info
162
+
All parameters to this endpoint are optional
163
+
:::
161
164
162
-
> info
163
-
> This endpoint supports the `X-Audit-Log-Reason` header.
165
+
:::info
166
+
This endpoint supports the `X-Audit-Log-Reason` header.
167
+
:::
164
168
165
169
###### JSON Params
166
170
@@ -180,8 +184,9 @@ Same as above, except this call does not require authentication, does not accept
180
184
181
185
Delete a webhook permanently. Requires the `MANAGE_WEBHOOKS` permission. Returns a `204 No Content` response on success. Fires a [Webhooks Update](/docs/events/gateway-events#webhooks-update) Gateway event.
182
186
183
-
> info
184
-
> This endpoint supports the `X-Audit-Log-Reason` header.
187
+
:::info
188
+
This endpoint supports the `X-Audit-Log-Reason` header.
@@ -193,14 +198,17 @@ Same as above, except this call does not require authentication.
193
198
194
199
Refer to [Uploading Files](/docs/reference#uploading-files) for details on attachments and `multipart/form-data` requests. Returns a message or `204 No Content` depending on the `wait` query parameter.
195
200
196
-
> info
197
-
> Note that when sending a message, you must provide a value for at **least one of**`content`, `embeds`, `components`, `file`, or `poll`.
201
+
:::info
202
+
Note that when sending a message, you must provide a value for at **least one of**`content`, `embeds`, `components`, `file`, or `poll`.
203
+
:::
198
204
199
-
> info
200
-
> If the webhook channel is a forum or media channel, you must provide either `thread_id` in the query string params, or `thread_name` in the JSON/form params. If `thread_id` is provided, the message will send in that thread. If `thread_name` is provided, a thread with that name will be created in the channel.
205
+
:::info
206
+
If the webhook channel is a forum or media channel, you must provide either `thread_id` in the query string params, or `thread_name` in the JSON/form params. If `thread_id` is provided, the message will send in that thread. If `thread_name` is provided, a thread with that name will be created in the channel.
207
+
:::
201
208
202
-
> warn
203
-
> Discord may strip certain characters from message content, like invalid unicode characters or characters which cause unexpected message formatting. If you are passing user-generated strings into message content, consider sanitizing the data to prevent unexpected behavior and using `allowed_mentions` to prevent unexpected mentions.
209
+
:::warn
210
+
Discord may strip certain characters from message content, like invalid unicode characters or characters which cause unexpected message formatting. If you are passing user-generated strings into message content, consider sanitizing the data to prevent unexpected behavior and using `allowed_mentions` to prevent unexpected mentions.
211
+
:::
204
212
205
213
###### Query String Params
206
214
@@ -233,8 +241,9 @@ Refer to [Uploading Files](/docs/reference#uploading-files) for details on attac
233
241
234
242
\*\* See [Uploading Files](/docs/reference#uploading-files) for details.
235
243
236
-
> info
237
-
> For the webhook embed objects, 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.
244
+
:::info
245
+
For the webhook embed objects, 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.
@@ -281,11 +290,13 @@ When the `content` field is edited, the `mentions` array in the message object w
281
290
Refer to [Uploading Files](/docs/reference#uploading-files) for details on attachments and `multipart/form-data` requests.
282
291
Any provided files will be **appended** to the message. To remove or replace files you will have to supply the `attachments` field which specifies the files to retain on the message after edit.
283
292
284
-
> warn
285
-
> Starting with API v10, the `attachments` array must contain all attachments that should be present after edit, including **retained and new** attachments provided in the request body.
293
+
:::warn
294
+
Starting with API v10, the `attachments` array must contain all attachments that should be present after edit, including **retained and new** attachments provided in the request body.
295
+
:::
286
296
287
-
> info
288
-
> All parameters to this endpoint are optional and nullable.
297
+
:::info
298
+
All parameters to this endpoint are optional and nullable.
0 commit comments