Document new pin endpoints #7585
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| <Route method="GET">/channels/[\{channel.id\}](/docs/resources/channel#channel-object)/pins</Route> | ||
|
|
||
| Gets the first 50 pinned messages in a channel, returning an array of [message](/docs/resources/message#message-object) objects on success. | ||
| This endpoint is deprecated. Use the one above instead. |
There was a problem hiding this comment.
The "above" might be confusing since it's a bit far away. This is a website, so we can use hrefs to refer to another section.
Suggested change
| This endpoint is deprecated. Use the one above instead. | |
| This endpoint is deprecated. Use [Get Channel Pins](/docs/resources/message#get-channel-pins) instead. |
I'd do the same for each deprecated endpoint.
1 task
6 tasks
Soheab
reviewed
Jun 14, 2025
| | Field | Type | Description | Default | | ||
| |---------|-------------------|-------------------------------------------|---------| | ||
| | before? | ISO8601 timestamp | Get messages pinned before this timestamp | absent | | ||
| | limit? | integer | Max number of pins to return (1-50) | 50 | |
There was a problem hiding this comment.
Suggested change
| | limit? | integer | Max number of pins to return (1-50) | 50 | | |
| | limit? | integer | Max number of pins to return (2-50) | 50 | |
Setting the limit to 1 throws the following:
400 Bad Request (error code: 50035): Invalid Form Body
In limit: int value should be greater than or equal to 2.
There was a problem hiding this comment.
probably better to support limits of 1 for consistency
Soheab
added a commit
to Soheab/discord.py
that referenced
this pull request
Jun 14, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.