diff --git a/docs/tools/index.md b/docs/tools/index.md
index 07815dba7e..7e6fa8017c 100644
--- a/docs/tools/index.md
+++ b/docs/tools/index.md
@@ -406,7 +406,7 @@ Core actions:
 Notes:
 
 - `add` expects a full cron job object (same schema as `cron.add` RPC).
-- `update` uses `{ id, patch }`.
+- `update` uses `{ jobId, patch }` (`id` accepted for compatibility).
 
 ### `gateway`