+
+ # Rate limits
+
+ We are rate-limiting all endpoints of PeerTube's API. Here is how it is configured by default:
+
+ | Endpoint | Calls | Time frame |
+ |-------------------------|------------------|---------------------------|
+ | `/*` | 50 | 10 seconds |
+ | `POST /users/token` | 15 | 5 minutes |
+ | `POST /users/register` | 2¹ | 5 minutes |
+ | `POST /users/ask-send-verify-email` | 3 | 5 minutes |
+
+ Depending on the endpoint, ¹failed requests are not taken into account. A service
+ limit is announced by a `429 Too Many Requests` status code.
+
+ You can get details about how your rate limit is going by reading following headers:
+
+ | Header | Description |
+ |-------------------------|------------------------------------------------------------|
+ | X-RateLimit-Limit | Number of max requests allowed in the current time period |
+ | X-RateLimit-Remaining | Number of remaining requests in the current time period |
+ | X-RateLimit-Reset | Timestamp of end of current time period as UNIX timestamp |
+ | Retry-After | Seconds to delay after the first `429` is received |