address comment

openapi.yaml

@@ -2424,10 +2424,12 @@ paths:
           required: false
           schema:
             type: string
-          description: Identifier for the last batch from the previous pagination request.
+          description: &pagination_after_param_description |
+            A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
         - name: limit
           in: query
-          description: Number of batches to retrieve.
+          description: &pagination_limit_param_description |
+            A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.
           required: false
           schema:
             type: integer
@@ -2449,7 +2451,7 @@ paths:
               curl https://api.openai.com/v1/batches?limit=2 \
                 -H "Authorization: Bearer $OPENAI_API_KEY" \
                 -H "Content-Type: application/json"
-          response: &batch_object |
+          response:
             {
               "object": "list",
               "data": [
@@ -2484,6 +2486,8 @@ paths:
                 },
                 { ... },
               ],
+              "first_id": "batch_abc123",
+              "last_id": "batch_abc456",
               "has_more": true
             }
 
@@ -2878,8 +2882,7 @@ paths:
       parameters:
         - name: limit
           in: query
-          description: &pagination_limit_param_description |
-            A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.
+          description: *pagination_limit_param_description
           required: false
           schema:
             type: integer
@@ -2894,8 +2897,7 @@ paths:
             enum: ["asc", "desc"]
         - name: after
           in: query
-          description: &pagination_after_param_description |
-            A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
+          description: *pagination_after_param_description
           schema:
             type: string
         - name: before
@@ -11615,6 +11617,12 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/Batch"
+        first_id:
+          type: string
+          example: "batch_abc123"
+        last_id:
+          type: string
+          example: "batch_abc456"
         has_more:
           type: boolean
         object: