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/events/gateway.mdx
+5-2Lines changed: 5 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -697,7 +697,8 @@ The [Get Gateway Bot endpoint](/docs/events/gateway#get-gateway-bot) will always
697
697
698
698
The session start limit for these bots will also be increased from 1000 to `max(2000, (guild_count / 1000) * 5)` per day. You also receive an increased `max_concurrency`, the number of [shards you can concurrently start](/docs/events/gateway#session-start-limit-object).
699
699
700
-
## Get Gateway % GET /gateway
700
+
## Get Gateway
701
+
<Routetype="GET">/gateway</Route>
701
702
702
703
:::info
703
704
This endpoint does not require authentication.
@@ -713,7 +714,9 @@ Returns an object with a valid WSS URL which the app can use when [Connecting](/
713
714
}
714
715
```
715
716
716
-
## Get Gateway Bot % GET /gateway/bot
717
+
## Get Gateway Bot
718
+
719
+
<Routetype="GET">/gateway/bot</Route>
717
720
718
721
:::warn
719
722
This endpoint requires authentication using a valid bot token.
Create a response to an Interaction. Body is an [interaction response](/docs/interactions/receiving-and-responding#interaction-response-object). Returns `204` unless `with_response` is set to `true` which returns `200` with the body as [interaction callback response](/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-response-object).
395
396
@@ -402,19 +403,23 @@ This endpoint also supports file attachments similar to the webhook endpoints. R
402
403
| with_response? |[boolean](/docs/reference#boolean-query-strings)| Whether to include an [interaction callback object](/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-response-object) as the response |
403
404
404
405
405
-
## Get Original Interaction Response % GET /webhooks/\{application.id/docs/resources/application#application-object\}/\{interaction.token/docs/interactions/receiving-and-responding#interaction-object\}/messages/@original
Apps are limited to 5 followup messages per interaction if it was initiated from a user-installed app and isn't installed in the server (meaning the [authorizing integration owners object](/docs/interactions/receiving-and-responding#interaction-object-authorizing-integration-owners-object) only contains `USER_INSTALL`)
@@ -424,14 +429,17 @@ Create a followup message for an Interaction. Functions the same as [Execute Web
424
429
425
430
When using this endpoint directly after responding to an interaction with `DEFERRED_CHANNEL_MESSAGE_WITH_SOURCE`, this endpoint will function as [Edit Original Interaction Response](/docs/interactions/receiving-and-responding#edit-original-interaction-response) for backwards compatibility. In this case, no new message will be created, and the loading message will be edited instead. The ephemeral flag will be ignored, and the value you provided in the initial defer response will be preserved, as an existing message's ephemeral state cannot be changed. This behavior is deprecated, and you should use the Edit Original Interaction Response endpoint in this case instead.
426
431
427
-
## Get Followup Message % GET /webhooks/\{application.id/docs/resources/application#application-object\}/\{interaction.token/docs/interactions/receiving-and-responding#interaction-object\}/messages/\{message.id/docs/resources/channel#message-object\}
Copy file name to clipboardExpand all lines: docs/resources/application-role-connection-metadata.mdx
+6-2Lines changed: 6 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,11 +38,15 @@ When a user connects their account using the bot's [`role_connections_verificati
38
38
Each metadata type offers a comparison operation that allows guilds to configure role requirements based on metadata values stored by the bot. Bots specify a `metadata value` for each user and guilds specify the required `guild's configured value` within the guild role settings.
39
39
:::
40
40
41
-
## Get Application Role Connection Metadata Records % GET /applications/{application.id/docs/resources/application#application-object}/role-connections/metadata
41
+
## Get Application Role Connection Metadata Records
Returns a list of [application role connection metadata](/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object) objects for the given application.
44
46
45
-
## Update Application Role Connection Metadata Records % PUT /applications/{application.id/docs/resources/application#application-object}/role-connections/metadata
47
+
## Update Application Role Connection Metadata Records
Updates and returns a list of [application role connection metadata](/docs/resources/application-role-connection-metadata#application-role-connection-metadata-object) objects for the given application.
Copy file name to clipboardExpand all lines: docs/resources/application.mdx
+14-17Lines changed: 14 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -182,9 +182,8 @@ 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.
187
-
:::
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.
188
187
189
188
## Install Links
190
189
@@ -194,9 +193,8 @@ Install links provide an easy way for users to install your app in Discord. If y
194
193
195
194
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.
196
195
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
-
:::
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`.
Instead, these links will prompt the user for the scopes and bot user permissions configured in your Default Install Settings.
212
210
213
-
:::info
214
-
Discord Provided Links are limited to the `application.commands` and `bot` scopes
215
-
:::
211
+
> info
212
+
> Discord Provided Links are limited to the `application.commands` and `bot` scopes
216
213
217
214
#### Custom URL
218
215
@@ -226,17 +223,18 @@ You can configure your app's install link in your [app's settings](https://disco
226
223
227
224
The Default Install Settings will appear on the **Installation** page when you have "Discord Provided Link" selected as your install link type.
228
225
229
-
## Get Current Application % GET /applications/@me
226
+
## Get Current Application
227
+
<Routetype="GET">/applications/@me</Route>
230
228
231
229
Returns the [application](/docs/resources/application#application-object) object associated with the requesting bot user.
232
230
233
-
## Edit Current Application % PATCH /applications/@me
231
+
## Edit Current Application
232
+
<Routetype="PATCH">/applications/@me</Route>
234
233
235
234
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.
236
235
237
-
:::info
238
-
All parameters to this endpoint are optional
239
-
:::
236
+
> info
237
+
> All parameters to this endpoint are optional
240
238
241
239
###### JSON Params
242
240
@@ -260,11 +258,11 @@ All parameters to this endpoint are optional
260
258
261
259
\*\* To update an Interactions endpoint URL via the API, the URL must be valid according to the [Receiving an Interaction](/docs/interactions/receiving-and-responding#receiving-an-interaction) documentation.
262
260
263
-
## Get Application Activity Instance % GET /applications/{application.id/docs/resources/application#application-object}/activity-instances/{instance_id}
Returns a serialized activity instance, if it exists. Useful for [preventing unwanted activity sessions](/docs/activities/development-guides#preventing-unwanted-activity-sessions).
266
265
267
-
268
266
###### Example Activity Instance
269
267
270
268
```json
@@ -293,7 +291,6 @@ Returns a serialized activity instance, if it exists. Useful for [preventing unw
293
291
| users | array of snowflakes, [user](/docs/resources/user#user-object) IDs | IDs of the Users currently connected to the instance |
294
292
295
293
296
-
297
294
###### Activity Location Object
298
295
299
296
The Activity Location is an object that describes the location in which an activity instance is running.
Copy file name to clipboardExpand all lines: docs/resources/audit-log.mdx
+2-1Lines changed: 2 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -197,7 +197,8 @@ For most objects, the change keys may be any field on the changed object. The fo
197
197
|[Partial Role](/docs/topics/permissions#role-object)|`$add` and `$remove` as keys |`new_value` is an array of objects that contain the role `id` and `name`|
198
198
|[Webhook](/docs/resources/webhook#webhook-object)|`avatar_hash` key (instead of `avatar`) ||
199
199
200
-
## Get Guild Audit Log % GET /guilds/{guild.id/docs/resources/guild#guild-object}/audit-logs
Returns an [audit log](/docs/resources/audit-log#audit-log-object) object for the guild. Requires the [`VIEW_AUDIT_LOG`](/docs/topics/permissions#permissions-bitwise-permission-flags) permission.
Copy file name to clipboardExpand all lines: docs/resources/auto-moderation.mdx
+10-5Lines changed: 10 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -198,23 +198,26 @@ value of [action type](/docs/resources/auto-moderation#auto-moderation-action-ob
198
198
Users are required to have the `MANAGE_GUILD` permission to access all Auto Moderation resources.
199
199
Some [action types](/docs/resources/auto-moderation#auto-moderation-action-object-action-types) require additional permissions, e.g. the `TIMEOUT` action type requires an additional `MODERATE_MEMBERS` permission.
200
200
201
-
## List Auto Moderation Rules for Guild % GET /guilds/{guild.id/docs/resources/guild#guild-object}/auto-moderation/rules
Get a list of all rules currently configured for the guild. Returns a list of [auto moderation rule](/docs/resources/auto-moderation#auto-moderation-rule-object) objects for the given guild.
204
205
205
206
:::info
206
207
This endpoint requires the `MANAGE_GUILD`[permission](/docs/resources/auto-moderation#auto-moderation-permission-requirements).
207
208
:::
208
209
209
-
## Get Auto Moderation Rule % GET /guilds/{guild.id/docs/resources/guild#guild-object}/auto-moderation/rules/{auto_moderation_rule.id/docs/resources/auto-moderation#auto-moderation-rule-object}
Create a new rule. Returns an [auto moderation rule](/docs/resources/auto-moderation#auto-moderation-rule-object) on success. Fires an [Auto Moderation Rule Create](/docs/events/gateway-events#auto-moderation-rule-create) Gateway event.
220
223
@@ -246,7 +249,8 @@ See [Trigger Types](/docs/resources/auto-moderation#auto-moderation-rule-object-
246
249
:::
247
250
248
251
249
-
## Modify Auto Moderation Rule % PATCH /guilds/{guild.id/docs/resources/guild#guild-object}/auto-moderation/rules/{auto_moderation_rule.id/docs/resources/auto-moderation#auto-moderation-rule-object}
Modify an existing rule. Returns an [auto moderation rule](/docs/resources/auto-moderation#auto-moderation-rule-object) on success. Fires an [Auto Moderation Rule Update](/docs/events/gateway-events#auto-moderation-rule-update) Gateway event.
252
256
@@ -276,7 +280,8 @@ This endpoint supports the `X-Audit-Log-Reason` header.
276
280
277
281
\* Can be omitted based on `trigger_type`. See the `Associated Trigger Types` column in [trigger metadata](/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata) to understand which `trigger_type` values require `trigger_metadata` to be set.
278
282
279
-
## Delete Auto Moderation Rule % DELETE /guilds/{guild.id/docs/resources/guild#guild-object}/auto-moderation/rules/{auto_moderation_rule.id/docs/resources/auto-moderation#auto-moderation-rule-object}
Delete a rule. Returns a `204` on success. Fires an [Auto Moderation Rule Delete](/docs/events/gateway-events#auto-moderation-rule-delete) Gateway event.
0 commit comments