From bc63968ecb463d0a7b4fcfd3acfc35b3d0e6c912 Mon Sep 17 00:00:00 2001 From: abalabahaha Date: Mon, 9 May 2016 23:25:35 -0700 Subject: [PATCH] Add bulk delete (#48) --- docs/resources/CHANNEL.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/resources/CHANNEL.md b/docs/resources/CHANNEL.md index fbc2fd200e..a19d267611 100644 --- a/docs/resources/CHANNEL.md +++ b/docs/resources/CHANNEL.md @@ -288,6 +288,19 @@ Delete a message. If operating on a guild channel and trying to delete a message >warn > This endpoint has a rate limit of 5 requests per second per guild. Requests which delete messages created within the last 10 seconds are not affected by this limit. +## Bulk Delete Messages % POST /channels/{channel.id#DOCS_CHANNEL/channel-objects}/messages/bulk\_delete + +Delete multiple messages in a single request. This endpoint can only be used on guild channels and requires the 'MANAGE_MESSAGES' permission. Returns a 204 empty response on success. Fires multiple [Message Delete](#DOCS_GATEWAY/message-delete) Gateway events. + +>warn +> This endpoint has a rate limit of 1 request per second per guild, and is limited to 100 messages per request. Only bot accounts can use this endpoint. + +###### JSON Params + +| Field | Type | Description | +|-------|------|-------------| +| messages | array of snowflakes | an array of message ids to delete | + ## Ack Message % POST /channels/{channel.id#DOCS_CHANNEL/channel-objects}/messages/{message.id#DOCS_CHANNEL/message-object}/ack Ack a message. Generally bots should **not** implement this route.