Skip to content

Commit 8c0dda7

Browse files
Update links
1 parent 69f48e6 commit 8c0dda7

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

docs/resources/message.mdx

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -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

10051012
Gets 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

Comments
 (0)