From 03bc55861f9cb72a9278e5ba9fd66f944d261305 Mon Sep 17 00:00:00 2001 From: Kyle McLaren Date: Mon, 17 Mar 2025 09:03:44 +0200 Subject: [PATCH] Machines API rate limit scope clarification --- machines/api/working-with-machines-api.html.markerb | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/machines/api/working-with-machines-api.html.markerb b/machines/api/working-with-machines-api.html.markerb index c52dc14c86..fb9a499f4c 100644 --- a/machines/api/working-with-machines-api.html.markerb +++ b/machines/api/working-with-machines-api.html.markerb @@ -77,6 +77,6 @@ Typically, 2xx HTTP status codes denote successful operations, 4xx codes imply f ## Rate Limits -Machines API rate limits apply _per-action_, _per-machine_. The limit is 1 request, per second, per action (i.e. Create Machine, Start Machine etc.) — with a short-term burst limit up to 3 req/s, per action. +Machines API rate limits apply _per-action_, _per-machine_ and are scoped per identifier. That might be Machine ID or App ID, depending on the type of request. The limit is 1 request, per second, per action (i.e. Create Machine, Start Machine etc.) — with a short-term burst limit up to 3 req/s, per action. This applies to all actions except [Get Machine](/docs/machines/api/machines-resource/#get-a-machine) which is 5 req/s, with a short-term burst limit up to 10 req/s.