coderabbit fixes

Author: isshaddad

docs/management/deployments/list.mdx

@@ -1,4 +1,5 @@
 ---
 title: "List deployments"
+description: "List all deployments for the authenticated environment, ordered by most recent first."
 openapi: "v3-openapi GET /api/v1/deployments"
 ---

docs/v3-openapi.yaml

@@ -799,10 +799,10 @@ paths:
           name: "page[size]"
           schema:
             type: integer
-            minimum: 1
+            minimum: 5
             maximum: 100
             default: 20
-          description: The number of deployments to return (default 20, max 100).
+          description: The number of deployments to return (default 20, min 5, max 100).
         - in: query
           name: status
           schema:
@@ -832,7 +832,7 @@ paths:
           name: to
           schema:
             type: string
-          description: Filter deployments created on or before this date (ISO 8601).
+          description: Filter deployments created on or before this date (ISO 8601). Only applied when `from` is also provided.
       responses:
         "200":
           description: Successful request
@@ -898,8 +898,7 @@ paths:
                     properties:
                       next:
                         type: string
-                        nullable: true
-                        description: Cursor for the next page. Pass as `page[after]` to get the next page. Null if there are no more results.
+                        description: Cursor for the next page. Pass as `page[after]` to get the next page. Omitted if there are no more results.
         "401":
           description: Unauthorized - Access token is missing or invalid
       tags:

docs/wait-for-token.mdx

@@ -70,14 +70,21 @@ The `publicAccessToken` returned by `wait.createToken()` is scoped to that speci
   </Step>
   <Step title="Complete the token from the browser">
     ```ts
-    await fetch(`https://api.trigger.dev/api/v1/waitpoints/tokens/${tokenId}/complete`, {
-      method: "POST",
-      headers: {
-        "Authorization": `Bearer ${publicAccessToken}`,
-        "Content-Type": "application/json",
-      },
-      body: JSON.stringify({ data: { status: "approved" } }),
-    });
+    const response = await fetch(
+      `https://api.trigger.dev/api/v1/waitpoints/tokens/${token.id}/complete`,
+      {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${token.publicAccessToken}`,
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ data: { status: "approved" } }),
+      }
+    );
+
+    if (!response.ok) {
+      throw new Error(`Failed to complete token: ${response.statusText}`);
+    }
     ```
   </Step>
 </Steps>