Rate limits
The general request budget, the per-action budgets and what a 429 looks like.
On this page
A budget is counted for each person, not for each token. A request refused for a missing scope is not counted.
Some requests meet a further limit, counted for the company, the environment, the CoreCluster or the calling address.
General budget
Endpoints without a budget of their own share one: 60 requests a minute for each person (api).
Every budget
Each endpoint's reference page names its budget. Requests that name the same budget spend it together.
The whole table
116
| Budget | Limit for each person |
|---|---|
agency-links-read | 60 a minute |
agency-links-write | 10 a minute |
api | 60 a minute |
corecluster-demos-read | 120 a minute |
corecluster-reveal | 5 every 10 minutes |
cse-deployment-settings-write | 60 a minute |
cse-variables-read | 120 a minute |
cse-variables-write | 20 a minute |
deployment-connections-read | 60 a minute |
deployment-connections-write | 10 a minute |
enterprise-copies-preview | 10 a minute |
enterprise-copies-write | 5 a minute |
environment-deploy-secrets-write | 20 a minute |
performance-audits-read | 120 a minute |
performance-audits-run | 10 a minute |
reseller-capacity | 60 a minute |
reseller-credentials | 10 a minute |
reseller-env-changes | 10 a minute |
reseller-http-auth-reveal | 10 a minute |
reseller-live | 20 a minute |
reseller-operations | 10 a minute |
reseller-platform-plugins-read | 120 a minute |
reseller-sets | 5 a minute |
reseller-snapshot-changes | 30 a minute |
reseller-snapshots | 10 a minute |
support-ticket-files | 60 a minute |
reseller-access-changes | 30 a minute |
reseller-access-read | 120 a minute |
corecluster-app-versions | 120 a minute |
corecluster-app-versions-attention | 60 a minute |
corecluster-app-versions-site | 120 a minute |
corecluster-site-create | 100 an hour |
reseller-provision | 100 an hour |
reseller-functions | 20 a minute |
reseller-attention | 60 a minute |
corecluster-auto-upgrades | 10 a minute |
corecluster-auto-upgrades-read | 120 a minute |
corecluster-billing-read | 120 a minute |
corecluster-billing-write | 30 a minute |
corecluster-demos-keep | 10 a minute |
corecluster-quote | 60 a minute |
corecluster-upgrades | 10 a minute |
reseller-clone | 5 a minute |
reseller-clone-queue | 10 a minute |
reseller-cloudflare-purge | 10 a minute |
reseller-cloudflare-rules | 20 a minute |
reseller-cloudflare | 6 a minute |
corecluster-capacity | 60 a minute |
corecluster-site-progress | 120 a minute |
reseller-sets | 10 a minute |
reseller-validate | 60 a minute |
reseller-database | 20 a minute |
reseller-database-read | 120 a minute |
reseller-database-reveal | 10 a minute |
corecluster-deploy-templates | 10 a minute |
corecluster-deploy-templates-read | 120 a minute |
corecluster-deploy-pipeline | 20 a minute |
corecluster-deploy-pipeline-read | 120 a minute |
reseller-deploy | 5 a minute |
reseller-deploy | 10 a minute |
reseller-deploy-browse | 30 a minute |
reseller-deploy-shared-files | 10 a minute |
reseller-dns-check | 20 a minute |
reseller-url-change | 5 a minute |
reseller-url-preview | 6 a minute |
corestack-email-read | 120 a minute |
reseller-email | 12 a minute |
reseller-env-create | 60 a minute |
reseller-env-starts-with | 60 a minute |
corecluster-feedback-burst | 30 a minute |
firewall-api-changes | 240 a minute |
firewall-api-read | 120 a minute |
firewall-api-write-requests | 120 a minute |
firewall-my-ip | 10 a minute |
firewall-range-requests | 10 an hour |
reseller-http-auth | 20 a minute |
corecluster-logs-download | 5 every 10 minutes |
corecluster-logs-query | 150 a minute |
corecluster-logs-saved | 30 a minute |
corecluster-nginx-logs | 30 a minute |
corecluster-magento | 120 a minute |
reseller-maintenance | 10 a minute |
reseller-cluster-changes | 5 a minute |
reseller-cluster-create | 10 an hour |
corecluster-websites | 120 a minute |
corecluster-nginx-convert | 20 an hour |
corecluster-nginx-explain | 60 a minute |
corecluster-nginx-read | 120 a minute |
corecluster-nginx-validate | 120 a minute |
corecluster-node-live | 10 a minute |
corecluster-node-lookup | 60 a minute |
corecluster-node-sets | 20 a minute |
corecluster-order-link | 60 a minute |
corecluster-orders | 120 a minute |
reseller-pagespeed | 10 a minute |
corecluster-php-test | 10 a minute |
corecluster-php-validate | 120 a minute |
corecluster-php-live | 20 a minute |
corecluster-php-requirements | 20 a minute |
corecluster-php-sets | 20 a minute |
corecluster-laravel | 120 a minute |
reseller-go-live | 5 a minute |
reseller-restore-deleted | 10 a minute |
api-move-size | 20 a minute |
corecluster-attention | 60 a minute |
corecluster-pending | 10 a minute |
corecluster-runtime | 10 a minute |
account-sign-out-everywhere | 5 a minute |
ssh-api-rotation | 30 an hour |
ssh-api-changes | 240 a minute |
ssh-api-read | 120 a minute |
corecluster-varnish-read | 120 a minute |
reseller-varnish-purge | 10 a minute |
corecluster-varnish-vcl-read | 120 a minute |
corecluster-varnish-vcl-validate | 120 a minute |
corecluster-varnish-vcl-write | 20 a minute |
Requests that meet several limits
These requests are counted against their budget and against further limits. Whichever is spent first refuses the request.
| Request | Its budget | Further limits |
|---|---|---|
GET / | 60 a minute (support-ticket-files) | 60 a minute for each person (api) |
DELETE / | 30 a minute (reseller-access-changes) | 30 a minute for each person (ssh-writes); 120 a minute for each company (ssh-writes) |
POST / | 30 a minute (reseller-access-changes) | 30 a minute for each person (ssh-writes); 120 a minute for each company (ssh-writes) |
POST / | 6 a minute (reseller-cloudflare) | 6 an hour for each company (reseller-magento-keys-check) |
POST /company/magento-keys/check | 6 a minute (reseller-cloudflare) | 6 an hour for each company (reseller-magento-keys-check) |
PUT / | 6 a minute (reseller-cloudflare) | 60 an hour for each company (reseller-cloudflare-writes) |
POST / | 10 a minute (reseller-cloudflare-purge) | 10 an hour for each environment (reseller-cloudflare-purge) |
POST / | 6 a minute (reseller-cloudflare) | 60 an hour for each company (reseller-cloudflare-writes) |
DELETE / | 6 a minute (reseller-cloudflare) | 60 an hour for each company (reseller-cloudflare-writes) |
POST / | 20 a minute (reseller-dns-check) | 60 an hour for each company (reseller-cloudflare-writes) |
POST / | 5 a minute (reseller-go-live) | 60 an hour for each company (reseller-cloudflare-writes) |
POST / | 12 a minute (reseller-email) | 3 an hour for each person (reseller-email-rotate) |
POST / | 12 a minute (reseller-email) | 20 a day for each environment (email-tests) |
GET / | 60 a minute (api) | 120 a minute for each person (corecluster-error-pages-read) |
PUT / | 60 a minute (api) | 20 a minute for each environment (corecluster-error-pages-save) |
POST / | 60 a minute (api) | 20 a minute for each environment (corecluster-error-pages-save) |
GET / | 60 a minute (api) | 120 a minute for each person (corecluster-error-pages-read) |
POST / | 60 a minute (api) | 120 a minute for each person (corecluster-error-pages-preview) |
POST / | 60 a minute (api) | 20 a minute for each environment (corecluster-error-pages-save) |
POST / | 60 a minute (api) | 20 a minute for each environment (corecluster-error-pages-save) |
POST / | 60 a minute (api) | 20 a minute for each environment (corecluster-error-pages-save) |
GET / | 60 a minute (api) | 120 a minute for each person (corecluster-error-pages-read) |
GET / | 60 a minute (api) | 120 a minute for each person (corecluster-error-pages-read) |
POST / | 60 a minute (api) | 6 a minute for each environment (corecluster-error-pages-test) |
POST / | 60 a minute (api) | 120 a minute for each person (corecluster-error-pages-preview) |
POST /corestack/feedback | 30 a minute (corecluster-feedback-burst) | 10 an hour for each person (feedback-submissions); 30 a day for each person (feedback-submissions); 100 a day for each company (feedback-submissions) |
POST /firewall/entries | 120 a minute (firewall-api-write-requests) | 30 a minute for each person (firewall-writes); 120 a minute for each company (firewall-writes) |
DELETE /firewall/entries/{entry} | 120 a minute (firewall-api-write-requests) | 30 a minute for each person (firewall-writes); 120 a minute for each company (firewall-writes) |
PATCH /firewall/entries/{entry} | 120 a minute (firewall-api-write-requests) | 30 a minute for each person (firewall-writes); 120 a minute for each company (firewall-writes) |
POST /firewall/my-ip | 10 a minute (firewall-my-ip) | 30 a minute for each person (firewall-writes); 120 a minute for each company (firewall-writes) |
POST /firewall/preset-subscriptions | 120 a minute (firewall-api-write-requests) | 30 a minute for each person (firewall-writes); 120 a minute for each company (firewall-writes) |
DELETE / | 120 a minute (firewall-api-write-requests) | 30 a minute for each person (firewall-writes); 120 a minute for each company (firewall-writes) |
POST /firewall/range-requests | 10 an hour (firewall-range-requests) | 30 a minute for each person (firewall-writes); 120 a minute for each company (firewall-writes) |
POST / | 20 a minute (reseller-functions) | 6 an hour for each environment (magento-varnish-config-repairs) |
DELETE /company/maintenance-window | 60 a minute (api) | 10 an hour for each company (maintenance-window-writes); 30 an hour for each person (maintenance-window-writes) |
PUT /company/maintenance-window | 60 a minute (api) | 10 an hour for each company (maintenance-window-writes); 30 an hour for each person (maintenance-window-writes) |
DELETE / | 60 a minute (api) | 10 an hour for each cluster (maintenance-window-writes); 30 an hour for each person (maintenance-window-writes) |
PUT / | 60 a minute (api) | 10 an hour for each cluster (maintenance-window-writes); 30 an hour for each person (maintenance-window-writes) |
DELETE / | 60 a minute (api) | 10 an hour for each environment (maintenance-window-writes); 30 an hour for each person (maintenance-window-writes) |
PUT / | 60 a minute (api) | 10 an hour for each environment (maintenance-window-writes); 30 an hour for each person (maintenance-window-writes) |
PUT / | 60 a minute (api) | 20 a minute for each environment (corecluster-nginx-save) |
PUT / | 60 a minute (api) | 20 a minute for each environment (corecluster-nginx-save) |
POST / | 60 a minute (api) | 20 a minute for each environment (corecluster-nginx-save) |
POST / | 60 a minute (api) | 20 a minute for each environment (corecluster-nginx-save) |
POST / | 60 a minute (api) | 20 a minute for each environment (corecluster-nginx-save) |
POST / | 60 a minute (api) | 20 a minute for each environment (corecluster-nginx-save) |
POST / | 120 a minute (corecluster-nginx-validate) | 10 a minute for each environment (corecluster-nginx-test) |
GET / | 60 a minute (api) | 10 a minute for each person (corecluster-node-live) |
POST / | 10 a minute (reseller-pagespeed) | 2 an hour for each environment (pagespeed-runs) |
POST /user/sign-out-everywhere | 5 a minute (account-sign-out-everywhere) | 60 a minute for each person (api) |
POST / | 30 an hour (ssh-api-rotation) | 6 an hour for each environment (ssh-host-key-rotation) |
POST /ssh/keys | 60 a minute (api) | 30 a minute for each person (ssh-writes); 120 a minute for each company (ssh-writes) |
DELETE /ssh/keys/{key} | 60 a minute (api) | 30 a minute for each person (ssh-writes); 120 a minute for each company (ssh-writes) |
PATCH /ssh/keys/{key} | 60 a minute (api) | 30 a minute for each person (ssh-writes); 120 a minute for each company (ssh-writes) |
POST /ssh/keys/{key}/keep | 60 a minute (api) | 30 a minute for each person (ssh-writes); 120 a minute for each company (ssh-writes) |
POST / | 10 a minute (reseller-varnish-purge) | 10 an hour for each environment (reseller-varnish-purge) |
PUT / | 20 a minute (corecluster-varnish-vcl-write) | 20 a minute for each environment (corecluster-varnish-vcl-save) |
POST / | 20 a minute (corecluster-varnish-vcl-write) | 20 a minute for each environment (corecluster-varnish-vcl-save) |
GET / meets its further limit only when it is sent with refresh.
Headers
| Header | Sent | Meaning |
|---|---|---|
X-RateLimit-Limit | With a 429, and on most other answers | Requests the budget allows |
X-RateLimit-Remaining | With a 429, and on most other answers | Requests left |
Retry-After | With a 429 | Seconds to wait |
X-RateLimit-Reset | With a 429 | Unix time when the budget resets |
When the budget is spent
{
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"code": "rate_limited",
"retry_after_seconds": 60
}Wait for Retry-After seconds, which retry_after_seconds repeats, then send the request again.
A further limit answers 429 with a reason of its own, which the endpoint's reference page names; Errors and refusals lists them. It carries retry_after_seconds too whenever the wait is known.