diff --git a/api-reference/admin-api/control-plane/api-keys/update-api-key.mdx b/api-reference/admin-api/control-plane/api-keys/update-api-key.mdx
index bfbc1b8b..b8feb04a 100644
--- a/api-reference/admin-api/control-plane/api-keys/update-api-key.mdx
+++ b/api-reference/admin-api/control-plane/api-keys/update-api-key.mdx
@@ -2,3 +2,15 @@
 title: Update API Key
 openapi: put /api-keys/{id}
 ---
+
+### Reset API key usage
+
+Use `reset_usage` when you want to clear the API key's current usage without changing other fields.
+
+```json
+{
+  "reset_usage": true
+}
+```
+
+If the key is currently `exhausted`, this reset reactivates it to `active` (when applicable). After the update, confirm the key reflects reset behavior in response fields such as `status` and `last_reset_at`.