@@ -972,6 +972,7 @@ Retrieves the list of pins in a channel. Requires the `VIEW_CHANNEL` permission.
972972| Field | Type | Description | Default |
973973| ---------| -------------------| -------------------------------------------| ---------|
974974| before? | ISO8601 timestamp | Get messages pinned before this timestamp | absent |
975+ | after? | ISO8601 timestamp | Get messages pinned after this timestamp | absent |
975976| limit? | integer | Max number of pins to return (1-50) | 50 |
976977
977978###### Response Structure
@@ -981,6 +982,12 @@ Retrieves the list of pins in a channel. Requires the `VIEW_CHANNEL` permission.
981982| items | array of [ message pin] ( /docs/resources/message#message-pin-object ) objects |
982983| has_more | boolean |
983984
985+ ###### Example
986+
987+ If you want to get 100 pins you'd send these two requests:
988+ ` GET /channels/:id/messages/pins?limit=50 `
989+ ` GET /channels/:id/messages/pins?limit=50&after={pins[pins.len() - 1].pinned_at} `
990+
984991## Pin Message
985992<Route method = " PUT" >/channels/[ \{ channel.id\} ] ( /docs/resources/channel#channel-object ) /messages/pins/[ \{ message.id\} ] ( /docs/resources/message#message-object ) </Route >
986993
@@ -1003,14 +1010,14 @@ This endpoint supports the `X-Audit-Log-Reason` header.
10031010<Route method = " GET" >/channels/[ \{ channel.id\} ] ( /docs/resources/channel#channel-object ) /pins</Route >
10041011
10051012Gets the first 50 pinned messages in a channel, returning an array of [ message] ( /docs/resources/message#message-object ) objects on success.
1006- This endpoint is deprecated. Use the one above instead.
1013+ This endpoint is deprecated. Use [ Get Channel Pins ] ( /docs/resources/message#get-channel-pins ) instead.
10071014
10081015## Pin Message (deprecated)
10091016<Route method = " PUT" >/channels/[ \{ channel.id\} ] ( /docs/resources/channel#channel-object ) /pins/[ \{ message.id\} ] ( /docs/resources/message#message-object ) </Route >
10101017
1011- This endpoint is deprecated. It functions the same as its non-deprecated counterpart .
1018+ This endpoint is deprecated. Use [ Pin Message ] ( /docs/resources/message#pin-message ) instead .
10121019
10131020## Unpin Message (deprecated)
10141021<Route method = " DELETE" >/channels/[ \{ channel.id\} ] ( /docs/resources/channel#channel-object ) /pins/[ \{ message.id\} ] ( /docs/resources/message#message-object ) </Route >
10151022
1016- This endpoint is deprecated. It functions the same as its non-deprecated counterpart .
1023+ This endpoint is deprecated. Use [ Unpin Message ] ( /docs/resources/message#unpin-message ) instead .
0 commit comments