feat(api): align beta pagination limits and non-null parameters

.castiron.stats.yml

@@ -1,8 +1,8 @@
 schema_version: 1
-generation_id: 0de453ad-6f0c-4771-864d-1596a085d328
-openapi_spec_hash: a4f99e9b86e86c9cedefa54aa55d0215
-openapi_transformed_spec_hash: a570fc3ac7c67d0e5fd1b3645e0a0ad5
+generation_id: 0dc2ed6b-5212-4044-b49d-2c6d60de1482
+openapi_spec_hash: db347f06272e97feb52de04cf9f5d97d
+openapi_transformed_spec_hash: b4eaee70c0715318e47ee8449ea1e803
 config_hash: 9f2131d7bd073baa8cb2730facaadf5a
-codegen_sha: 4c9b47414532b3fb814e63f9718b9addc1dd3937
-codegen_hash: 003368ecafa37a4d43c9b08369657449af8318f668282e3832ec680fd965f64e
-public_codegen_sha: 2bc9fe4ad59831f756d320d7a7eb845e06cfe237
+codegen_sha: aa2e4495602dda9732b64aaf1ed1e572e3b30f42
+codegen_hash: 07d7a391cb327c8d70dd18e1878635ebb0c8d87acdc6eebd3fff6bea232a661a
+public_codegen_sha: 502686aec876a8af283c91c38583979f4f8e30be

api_reference/openapi.transformed.yml

@@ -31155,12 +31155,12 @@ paths:
         in: query
         required: false
         schema:
-          type:
-          - integer
-          - 'null'
+          type: integer
           format: int64
           minimum: 1
-        description: The maximum number of resources to return.
+          maximum: 100
+          default: 20
+        description: The maximum number of resources to return, between 1 and 100. Defaults to 20.
       - name: order
         in: query
         required: false
@@ -31964,35 +31964,35 @@ paths:
         in: query
         required: false
         schema:
-          type:
-          - integer
-          - 'null'
+          type: integer
           format: int64
           minimum: 1
-        description: The maximum number of resources to return.
+          maximum: 100
+          default: 20
+        description: The maximum number of resources to return, between 1 and 100. Defaults to 20.
       - name: order
         in: query
         required: false
         schema:
           $ref: '#/components/schemas/ListOrderParam'
           default: desc
-        description: Sort order by the `created_at` timestamp. Use `asc` for ascending order or `desc` for descending order. Defaults to `desc`.
-      - name: agent_id
+        description: The order in which resources are returned. Defaults to `desc`.
+      - name: after
         in: query
         required: false
         schema:
           type: string
           minLength: 0
           maxLength: 1048576
-        description: Only return sessions whose root agent has this ID. Omit to return sessions for all agents.
-      - name: after
+        description: Return resources after this resource ID in the selected order.
+      - name: agent_id
         in: query
         required: false
         schema:
           type: string
           minLength: 0
           maxLength: 1048576
-        description: Return resources after this resource ID in the selected order.
+        description: Only return sessions whose root agent has this ID. Omit to return sessions for all agents.
       responses:
         '200':
           description: A page of sessions.
@@ -32329,34 +32329,32 @@ paths:
           minLength: 0
           maxLength: 1048576
         description: The ID of the session.
+      - name: limit
+        in: query
+        required: false
+        schema:
+          type: integer
+          format: int64
+          minimum: 1
+          maximum: 100
+          default: 20
+        description: The maximum number of resources to return, between 1 and 100. Defaults to 20.
       - name: order
         in: query
         required: false
         schema:
           $ref: '#/components/schemas/ListOrderParam'
-        description: Sort by creation time and ID. Defaults to descending.
-      - name: environment_id
+          default: desc
+        description: The order in which resources are returned. Defaults to `desc`.
+      - name: after
         in: query
         required: false
         schema:
-          type:
-          - string
-          - 'null'
+          type: string
           minLength: 0
           maxLength: 1048576
-        description: Restrict the listing to artifacts produced by this environment.
-      - name: limit
-        in: query
-        required: false
-        schema:
-          type:
-          - integer
-          - 'null'
-          format: int64
-          minimum: 1
-          maximum: 100
-        description: The maximum number of artifacts to return, between 1 and 100.
-      - name: after
+        description: Return resources after this resource ID in the selected order.
+      - name: environment_id
         in: query
         required: false
         schema:
@@ -32365,7 +32363,7 @@ paths:
           - 'null'
           minLength: 0
           maxLength: 1048576
-        description: Return artifacts after this immutable artifact ID.
+        description: Restrict the listing to artifacts produced by this environment.
       responses:
         '200':
           description: A page of durable session artifacts.
@@ -33227,29 +33225,23 @@ paths:
       tags:
       - Vaults
       parameters:
-      - name: order
-        in: query
-        required: false
-        schema:
-          $ref: '#/components/schemas/ListOrderParam'
-          default: desc
-        description: Sort order by the `created_at` timestamp. Use `asc` for ascending order or `desc` for descending order. Defaults to `desc`.
       - name: limit
         in: query
         required: false
         schema:
-          type:
-          - integer
-          - 'null'
+          type: integer
           format: int64
-          minimum: 0
-        description: The maximum number of resources to return. Defaults to 20. Values are clamped between 1 and 100.
-      - name: status
+          minimum: 1
+          maximum: 100
+          default: 20
+        description: The maximum number of resources to return, between 1 and 100. Defaults to 20.
+      - name: order
         in: query
         required: false
         schema:
-          $ref: '#/components/schemas/VaultStatusFilterParam'
-        description: Filter by one status or a list, such as `status=active` or `status[]=active&status[]=archived`. Both statuses are included by default.
+          $ref: '#/components/schemas/ListOrderParam'
+          default: desc
+        description: The order in which resources are returned. Defaults to `desc`.
       - name: after
         in: query
         required: false
@@ -33276,6 +33268,12 @@ paths:
         description: Exact string matches supplied as `metadata[key]=value`. All supplied pairs must match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512 characters. Filtering is eventually consistent; metadata changes may take time to appear.
         style: deepObject
         explode: true
+      - name: status
+        in: query
+        required: false
+        schema:
+          $ref: '#/components/schemas/VaultStatusFilterParam'
+        description: Filter by one status or a list, such as `status=active` or `status[]=active&status[]=archived`. Both statuses are included by default.
       responses:
         '200':
           description: A page of vaults.
@@ -33603,29 +33601,23 @@ paths:
           minLength: 0
           maxLength: 1048576
         description: The ID of the vault.
-      - name: order
-        in: query
-        required: false
-        schema:
-          $ref: '#/components/schemas/ListOrderParam'
-          default: desc
-        description: Sort order by the `created_at` timestamp. Use `asc` for ascending order or `desc` for descending order. Defaults to `desc`.
       - name: limit
         in: query
         required: false
         schema:
-          type:
-          - integer
-          - 'null'
+          type: integer
           format: int64
-          minimum: 0
-        description: The maximum number of resources to return. Defaults to 20. Values are clamped between 1 and 100.
-      - name: status
+          minimum: 1
+          maximum: 100
+          default: 20
+        description: The maximum number of resources to return, between 1 and 100. Defaults to 20.
+      - name: order
         in: query
         required: false
         schema:
-          $ref: '#/components/schemas/VaultStatusFilterParam'
-        description: Filter by one status or a list, such as `status=active` or `status[]=active&status[]=archived`. Both statuses are included by default.
+          $ref: '#/components/schemas/ListOrderParam'
+          default: desc
+        description: The order in which resources are returned. Defaults to `desc`.
       - name: after
         in: query
         required: false
@@ -33652,6 +33644,12 @@ paths:
         description: Exact string matches supplied as `metadata[key]=value`. All supplied pairs must match. Up to 16 pairs, with keys from 1 to 64 characters and values up to 512 characters. Filtering is eventually consistent; metadata changes may take time to appear.
         style: deepObject
         explode: true
+      - name: status
+        in: query
+        required: false
+        schema:
+          $ref: '#/components/schemas/VaultStatusFilterParam'
+        description: Filter by one status or a list, such as `status=active` or `status[]=active&status[]=archived`. Both statuses are included by default.
       responses:
         '200':
           description: A page of vault credentials.

src/openai/resources/beta/agents/agents.py

@@ -305,7 +305,7 @@ def list(
         self,
         *,
         after: str | Omit = omit,
-        limit: Optional[int] | Omit = omit,
+        limit: int | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -322,7 +322,7 @@ def list(
         Args:
           after: Return resources after this resource ID in the selected order.
 
-          limit: The maximum number of resources to return.
+          limit: The maximum number of resources to return, between 1 and 100. Defaults to 20.
 
           order: The order in which resources are returned. Defaults to `desc`.
 
@@ -655,7 +655,7 @@ def list(
         self,
         *,
         after: str | Omit = omit,
-        limit: Optional[int] | Omit = omit,
+        limit: int | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -672,7 +672,7 @@ def list(
         Args:
           after: Return resources after this resource ID in the selected order.
 
-          limit: The maximum number of resources to return.
+          limit: The maximum number of resources to return, between 1 and 100. Defaults to 20.
 
           order: The order in which resources are returned. Defaults to `desc`.
 

src/openai/resources/beta/agents/sessions/artifacts.py

@@ -104,9 +104,9 @@ def list(
         self,
         session_id: str,
         *,
-        after: Optional[str] | Omit = omit,
+        after: str | Omit = omit,
         environment_id: Optional[str] | Omit = omit,
-        limit: Optional[int] | Omit = omit,
+        limit: int | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -121,13 +121,13 @@ def list(
         [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).
 
         Args:
-          after: Return artifacts after this immutable artifact ID.
+          after: Return resources after this resource ID in the selected order.
 
           environment_id: Restrict the listing to artifacts produced by this environment.
 
-          limit: The maximum number of artifacts to return, between 1 and 100.
+          limit: The maximum number of resources to return, between 1 and 100. Defaults to 20.
 
-          order: Sort by creation time and ID. Defaults to descending.
+          order: The order in which resources are returned. Defaults to `desc`.
 
               - `asc` - Returns resources in ascending order.
               - `desc` - Returns resources in descending order.
@@ -332,9 +332,9 @@ def list(
         self,
         session_id: str,
         *,
-        after: Optional[str] | Omit = omit,
+        after: str | Omit = omit,
         environment_id: Optional[str] | Omit = omit,
-        limit: Optional[int] | Omit = omit,
+        limit: int | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -349,13 +349,13 @@ def list(
         [session artifacts](https://developers.openai.com/api/docs/guides/agents-api/environments/files#openai-hosted-artifacts).
 
         Args:
-          after: Return artifacts after this immutable artifact ID.
+          after: Return resources after this resource ID in the selected order.
 
           environment_id: Restrict the listing to artifacts produced by this environment.
 
-          limit: The maximum number of artifacts to return, between 1 and 100.
+          limit: The maximum number of resources to return, between 1 and 100. Defaults to 20.
 
-          order: Sort by creation time and ID. Defaults to descending.
+          order: The order in which resources are returned. Defaults to `desc`.
 
               - `asc` - Returns resources in ascending order.
               - `desc` - Returns resources in descending order.

src/openai/resources/beta/agents/sessions/sessions.py

@@ -480,7 +480,7 @@ def list(
         *,
         after: str | Omit = omit,
         agent_id: str | Omit = omit,
-        limit: Optional[int] | Omit = omit,
+        limit: int | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -500,10 +500,9 @@ def list(
           agent_id: Only return sessions whose root agent has this ID. Omit to return sessions for
               all agents.
 
-          limit: The maximum number of resources to return.
+          limit: The maximum number of resources to return, between 1 and 100. Defaults to 20.
 
-          order: Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-              `desc` for descending order. Defaults to `desc`.
+          order: The order in which resources are returned. Defaults to `desc`.
 
               - `asc` - Returns resources in ascending order.
               - `desc` - Returns resources in descending order.
@@ -986,7 +985,7 @@ def list(
         *,
         after: str | Omit = omit,
         agent_id: str | Omit = omit,
-        limit: Optional[int] | Omit = omit,
+        limit: int | Omit = omit,
         order: Literal["asc", "desc"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -1006,10 +1005,9 @@ def list(
           agent_id: Only return sessions whose root agent has this ID. Omit to return sessions for
               all agents.
 
-          limit: The maximum number of resources to return.
+          limit: The maximum number of resources to return, between 1 and 100. Defaults to 20.
 
-          order: Sort order by the `created_at` timestamp. Use `asc` for ascending order or
-              `desc` for descending order. Defaults to `desc`.
+          order: The order in which resources are returned. Defaults to `desc`.
 
               - `asc` - Returns resources in ascending order.
               - `desc` - Returns resources in descending order.