Skip to main content
The reference lists every endpoint, field and response.

​
Tokens

Create tokens on the dashboard Developers page (Manage Server required). A token starts with pct_, is shown once, belongs to one server, and a server can hold 10 active tokens. Revoking takes effect immediately. Changes made with a token appear in the change log as api:<token name>. GET /guilds/{guild_id} needs only a valid token for that server. GET /bot/stats needs no token.

​
Rate limits

60 requests per minute per token, burst 20 (unauthenticated: 30 per minute per IP). Responses carry X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Over the limit returns 429 rate_limited with Retry-After in seconds.

​
Idempotency

Send Idempotency-Key (1 to 64 characters of A-Za-z0-9-_.:) on balance PATCH, inventory POST and inventory DELETE. The same key and request within 24 hours returns the first response with Idempotent-Replayed: true. A different request with the same key returns 422 idempotency_key_reuse; one still running returns 409 request_in_progress.

​
Errors

Use code in programs; message may change. Retry 5xx and 429, not other 4xx. Examples: curl, JavaScript and Python. For events pushed to you, use outbound webhooks on the dashboard.