feat(api): /browsers no longer requires invocation id

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 16
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-2aec229ccf91f7c1ac95aa675ea2a59bd61af9e363a22c3b49677992f1eeb16a.yml
-openapi_spec_hash: c80cd5d52a79cd5366a76d4a825bd27a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-ff8ccba8b5409eaa1128df9027582cb63f66e8accd75e511f70b7c27ef26c9ae.yml
+openapi_spec_hash: 1dbacc339695a7c78718f90f791d3f01
 config_hash: b8e1fff080fbaa22656ab0a57b591777

src/resources/browsers.ts

@@ -13,12 +13,13 @@ export class Browsers extends APIResource {
    *
    * @example
    * ```ts
-   * const browser = await client.browsers.create({
-   *   invocation_id: 'rr33xuugxj9h0bkf1rdt2bet',
-   * });
+   * const browser = await client.browsers.create();
    * ```
    */
-  create(body: BrowserCreateParams, options?: RequestOptions): APIPromise<BrowserCreateResponse> {
+  create(
+    body: BrowserCreateParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<BrowserCreateResponse> {
     return this._client.post('/browsers', { body, ...options });
   }
 
@@ -169,7 +170,7 @@ export interface BrowserCreateParams {
   /**
    * action invocation ID
    */
-  invocation_id: string;
+  invocation_id?: string;
 
   /**
    * Optional persistence configuration for the browser session.

tests/api-resources/browsers.test.ts

@@ -9,8 +9,8 @@ const client = new Kernel({
 
 describe('resource browsers', () => {
   // skipped: tests are disabled for the time being
-  test.skip('create: only required params', async () => {
-    const responsePromise = client.browsers.create({ invocation_id: 'rr33xuugxj9h0bkf1rdt2bet' });
+  test.skip('create', async () => {
+    const responsePromise = client.browsers.create();
     const rawResponse = await responsePromise.asResponse();
     expect(rawResponse).toBeInstanceOf(Response);
     const response = await responsePromise;
@@ -21,12 +21,18 @@ describe('resource browsers', () => {
   });
 
   // skipped: tests are disabled for the time being
-  test.skip('create: required and optional params', async () => {
-    const response = await client.browsers.create({
-      invocation_id: 'rr33xuugxj9h0bkf1rdt2bet',
-      persistence: { id: 'my-awesome-browser-for-user-1234' },
-      stealth: true,
-    });
+  test.skip('create: 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.browsers.create(
+        {
+          invocation_id: 'rr33xuugxj9h0bkf1rdt2bet',
+          persistence: { id: 'my-awesome-browser-for-user-1234' },
+          stealth: true,
+        },
+        { path: '/_stainless_unknown_path' },
+      ),
+    ).rejects.toThrow(Kernel.NotFoundError);
   });
 
   // skipped: tests are disabled for the time being