Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/discordplace/discord.place/llms.txt

Use this file to discover all available pages before exploring further.

Keep your bot’s listing accurate by periodically pushing your current server and command counts. At least one field must be provided per request.

Endpoint

PATCH /bots/{id}/stats
Authentication: Required — pass your API key in the Authorization header.
See Authentication for details.

Path Parameters

id
string
required
The Discord snowflake ID of your bot (a 17–20 digit numeric string).Example: 123456789012345678

Request Body

At least one of the following fields must be present.
server_count
integer
The number of servers your bot is currently in. Must be between 0 and 10,000,000.The value you provide cannot differ from your bot’s actual server count by more than the configured maximum difference (at minimum 50, or 10% of the actual count — whichever is larger). Exceeding this threshold returns a 400 error.Example: 1500
command_count
integer
The number of slash/prefix commands your bot exposes. Must be between 0 and 1,000.Example: 100

Code Examples

curl -X PATCH https://api.discord.place/bots/123456789012345678/stats \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server_count": 1500, "command_count": 100}'

Responses

200 — Success

success
boolean
Always true on a successful update.
{ "success": true }

Error Responses

Tips

Call this endpoint on a scheduled interval (e.g., every hour) rather than reacting to every guild join/leave event. The rate limit is 2 requests per 120 minutes, so a once-per-hour schedule leaves headroom for retries.

Build docs developers (and LLMs) love