feat(api): update API spec with pagination headers

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-33f1feaba7bde46bfa36d2fefb5c3bc9512967945bccf78045ad3f64aafc4eb0.yml
-openapi_spec_hash: 52a448889d41216d1ca30e8a57115b14
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-cb38560915edce03abce2ae3ef5bc745489dbe9b6f80c2b4ff42edf8c2ff276d.yml
+openapi_spec_hash: a869194d6c864ba28d79ec0105439c3e
 config_hash: 1f28d5c3c063f418ebd2799df1e4e781

src/resources/deployments.ts

@@ -45,15 +45,13 @@ export class Deployments extends APIResource {
    * @example
    * ```ts
    * // Automatically fetches more pages as needed.
-   * for await (const deploymentListResponse of client.deployments.list(
-   *   { app_name: 'app_name' },
-   * )) {
+   * for await (const deploymentListResponse of client.deployments.list()) {
    *   // ...
    * }
    * ```
    */
   list(
-    query: DeploymentListParams,
+    query: DeploymentListParams | null | undefined = {},
     options?: RequestOptions,
   ): PagePromise<DeploymentListResponsesOffsetPagination, DeploymentListResponse> {
     return this._client.getAPIList('/deployments', OffsetPagination<DeploymentListResponse>, {
@@ -384,7 +382,7 @@ export interface DeploymentListParams extends OffsetPaginationParams {
   /**
    * Filter results by application name.
    */
-  app_name: string;
+  app_name?: string;
 }
 
 export interface DeploymentFollowParams {

tests/api-resources/deployments.test.ts

@@ -48,8 +48,8 @@ describe('resource deployments', () => {
   });
 
   // Prism tests are disabled
-  test.skip('list: only required params', async () => {
-    const responsePromise = client.deployments.list({ app_name: 'app_name' });
+  test.skip('list', async () => {
+    const responsePromise = client.deployments.list();
     const rawResponse = await responsePromise.asResponse();
     expect(rawResponse).toBeInstanceOf(Response);
     const response = await responsePromise;
@@ -60,8 +60,14 @@ describe('resource deployments', () => {
   });
 
   // Prism tests are disabled
-  test.skip('list: required and optional params', async () => {
-    const response = await client.deployments.list({ app_name: 'app_name', limit: 1, offset: 0 });
+  test.skip('list: request options and params are passed correctly', async () => {
+    // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
+    await expect(
+      client.deployments.list(
+        { app_name: 'app_name', limit: 1, offset: 0 },
+        { path: '/_stainless_unknown_path' },
+      ),
+    ).rejects.toThrow(Kernel.NotFoundError);
   });
 
   // Prism doesn't support text/event-stream responses