diff --git a/doc/api/garage-admin-v2.json b/doc/api/garage-admin-v2.json
index 69b2d75b..1aa53095 100644
--- a/doc/api/garage-admin-v2.json
+++ b/doc/api/garage-admin-v2.json
@@ -4351,6 +4351,33 @@
         }
       },
       "WorkerStateResp": {
+        "oneOf": [
+          {
+            "type": "object",
+            "required": [
+              "throttled"
+            ],
+            "properties": {
+              "throttled": {
+                "type": "object",
+                "required": [
+                  "durationSecs"
+                ],
+                "properties": {
+                  "durationSecs": {
+                    "type": "number",
+                    "format": "float"
+                  }
+                }
+              }
+            }
+          },
+          {
+            "$ref": "#/components/schemas/WorkerStateRespStrs"
+	  }
+        ]
+      },
+      "WorkerStateRespStrs": {
         "type": "string",
         "enum": [
           "busy",