feat(api): add delete_browsers endpoint

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 15
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-5d4e11bc46eeecee7363d56a9dfe946acee997d5b352c2b0a50c20e742c54d2d.yml
-openapi_spec_hash: 333e53ad9c706296b9afdb8ff73bec8f
-config_hash: 0fdf285ddd8dee229fd84ea57df9080f
+configured_endpoints: 16
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-b019e469425a59061f37c5fdc7a131a5291c66134ef0627db4f06bb1f4af0b15.yml
+openapi_spec_hash: f66a3c2efddb168db9539ba2507b10b8
+config_hash: aae6721b2be9ec8565dfc8f7eadfe105

api.md

@@ -59,6 +59,7 @@ Methods:
 - <code title="post /invocations">client.invocations.<a href="./src/resources/invocations.ts">create</a>({ ...params }) -> InvocationCreateResponse</code>
 - <code title="get /invocations/{id}">client.invocations.<a href="./src/resources/invocations.ts">retrieve</a>(id) -> InvocationRetrieveResponse</code>
 - <code title="patch /invocations/{id}">client.invocations.<a href="./src/resources/invocations.ts">update</a>(id, { ...params }) -> InvocationUpdateResponse</code>
+- <code title="delete /invocations/{id}/browsers">client.invocations.<a href="./src/resources/invocations.ts">deleteBrowsers</a>(id) -> void</code>
 - <code title="get /invocations/{id}/events">client.invocations.<a href="./src/resources/invocations.ts">follow</a>(id) -> InvocationFollowResponse</code>
 
 # Browsers

src/resources/invocations.ts

@@ -57,6 +57,21 @@ export class Invocations extends APIResource {
     return this._client.patch(path`/invocations/${id}`, { body, ...options });
   }
 
+  /**
+   * Delete all browser sessions created within the specified invocation.
+   *
+   * @example
+   * ```ts
+   * await client.invocations.deleteBrowsers('id');
+   * ```
+   */
+  deleteBrowsers(id: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/invocations/${id}/browsers`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
   /**
    * Establishes a Server-Sent Events (SSE) stream that delivers real-time logs and
    * status updates for an invocation. The stream terminates automatically once the

tests/api-resources/invocations.test.ts

@@ -64,6 +64,18 @@ describe('resource invocations', () => {
     const response = await client.invocations.update('id', { status: 'succeeded', output: 'output' });
   });
 
+  // skipped: tests are disabled for the time being
+  test.skip('deleteBrowsers', async () => {
+    const responsePromise = client.invocations.deleteBrowsers('id');
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
   // skipped: currently no good way to test endpoints with content type text/event-stream, Prism mock server will fail
   test.skip('follow', async () => {
     const responsePromise = client.invocations.follow('id');