Skip to content

Commit 27ffb2b

Browse files
weird
1 parent a918abf commit 27ffb2b

File tree

2 files changed

+45
-30
lines changed

2 files changed

+45
-30
lines changed

docs/resources/application.mdx

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -182,8 +182,9 @@ By default, newly-created apps only support installation to guilds.
182182

183183
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.
184184

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+
:::
187188

188189
## Install Links
189190

@@ -193,8 +194,9 @@ Install links provide an easy way for users to install your app in Discord. If y
193194

194195
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.
195196

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`.
199+
:::
198200

199201
#### Discord Provided Link
200202

@@ -208,8 +210,9 @@ https://discord.com/oauth2/authorize?client_id=1234567895647001626
208210

209211
Instead, these links will prompt the user for the scopes and bot user permissions configured in your Default Install Settings.
210212

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+
:::
213216

214217
#### Custom URL
215218

@@ -233,8 +236,9 @@ Returns the [application](/docs/resources/application#application-object) object
233236

234237
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.
235238

236-
> info
237-
> All parameters to this endpoint are optional
239+
:::info
240+
All parameters to this endpoint are optional
241+
:::
238242

239243
###### JSON Params
240244

docs/resources/webhook.mdx

Lines changed: 33 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,9 @@ Used to represent a webhook.
3333

3434
###### Webhook Types
3535

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.
38+
:::
3839

3940
| Value | Name | Description |
4041
|-------|------------------|----------------------------------------------------------------------------------------------------------------|
@@ -118,8 +119,9 @@ An error will be returned if a webhook name (`name`) is not valid. A webhook nam
118119
- It does not contain the substrings `clyde` or `discord` (case-insensitive)
119120
- 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
120121

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+
:::
123125

124126
###### JSON Params
125127

@@ -156,11 +158,13 @@ Same as above, except this call does not require authentication and returns no u
156158

157159
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.
158160

159-
> info
160-
> All parameters to this endpoint are optional
161+
:::info
162+
All parameters to this endpoint are optional
163+
:::
161164

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+
:::
164168

165169
###### JSON Params
166170

@@ -180,8 +184,9 @@ Same as above, except this call does not require authentication, does not accept
180184

181185
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.
182186

183-
> info
184-
> This endpoint supports the `X-Audit-Log-Reason` header.
187+
:::info
188+
This endpoint supports the `X-Audit-Log-Reason` header.
189+
:::
185190

186191
## Delete Webhook with Token
187192
<Route method="DELETE">/webhooks/[\{webhook.id\}](/docs/resources/webhook#webhook-object)/[\{webhook.token\}](/docs/resources/webhook#webhook-object)</Route>
@@ -193,14 +198,17 @@ Same as above, except this call does not require authentication.
193198

194199
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.
195200

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+
:::
198204

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+
:::
201208

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+
:::
204212

205213
###### Query String Params
206214

@@ -233,8 +241,9 @@ Refer to [Uploading Files](/docs/reference#uploading-files) for details on attac
233241

234242
\*\* See [Uploading Files](/docs/reference#uploading-files) for details.
235243

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.
246+
:::
238247

239248
## Execute Slack-Compatible Webhook
240249
<Route method="POST">/webhooks/[\{webhook.id\}](/docs/resources/webhook#webhook-object)/[\{webhook.token\}](/docs/resources/webhook#webhook-object)/slack</Route>
@@ -281,11 +290,13 @@ When the `content` field is edited, the `mentions` array in the message object w
281290
Refer to [Uploading Files](/docs/reference#uploading-files) for details on attachments and `multipart/form-data` requests.
282291
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.
283292

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+
:::
286296

287-
> info
288-
> All parameters to this endpoint are optional and nullable.
297+
:::info
298+
All parameters to this endpoint are optional and nullable.
299+
:::
289300

290301
###### Query String Params
291302

0 commit comments

Comments
 (0)