docs: Update API docs (#4209)

* docs: Update API docs

* docs: Update content

* docs: Update content

* docs: Update content

* docs: Fix typos and word choice

* docs: Revisions, add graphic

* Apply batch of suggestions from code review

Co-authored-by: Johan Brandhorst-Satzkorn <johan.brandhorst@gmail.com>

* docs: Deleting unnecessary content

* docs: Clarify deleted items

* docs: Add new limitation

* docs: Remove list tokens section

* docs: Update `list` command pages

* Update website/content/docs/api-clients/api/index.mdx

Co-authored-by: Johan Brandhorst-Satzkorn <johan.brandhorst@gmail.com>

* docs: Remove new options from worker doc

---------

Co-authored-by: Johan Brandhorst-Satzkorn <johan.brandhorst@gmail.com>

website/data/docs-nav-data.json

@@ -1368,7 +1368,20 @@
       },
       {
         "title": "API",
-        "path": "api-clients/api"
+        "routes": [
+          {
+            "title": "Overview",
+            "path": "api-clients/api"
+          },
+          {
+            "title": "Rate limiting",
+            "path": "api-clients/api/rate-limiting"
+          },
+          {
+            "title": "List pagination",
+            "path": "api-clients/api/pagination"
+          }
+        ]
       },
       {
         "title": "Go SDK",