feat: [AI-1972] - Move fetch v2 handler into /v1/fetch

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-1821faac6d1422fea15b3ba1f88c0f5f00c43464524e17d3fd1efd1ea148b7c4.yml
-openapi_spec_hash: 1e3fba074314f557dc6973cf97ea6a69
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-3032c74460ad9c1c4b0a1b2d9107c556f292974a8ce12d525660a9cf31f10bc1.yml
+openapi_spec_hash: 8ac1c673ce4e72b88bbbf30100b95e8f
 config_hash: cf04ecfb8dad5fbd8b85be25d6e9ec55

src/resources/fetch-api.ts

@@ -61,10 +61,23 @@ export interface FetchAPICreateParams {
    */
   allowRedirects?: boolean;
 
+  /**
+   * Output format for the response content. `raw` (default) returns the response
+   * body unchanged; `json` returns structured data (requires `schema`); `markdown`
+   * returns the page as markdown.
+   */
+  format?: 'raw' | 'json' | 'markdown';
+
   /**
    * Whether to enable proxy support for the request
    */
   proxies?: boolean;
+
+  /**
+   * JSON Schema describing the desired structure of the response. Only used when
+   * `format` is `json`.
+   */
+  schema?: { [key: string]: unknown };
 }
 
 export declare namespace FetchAPI {

tests/api-resources/fetch-api.test.ts

@@ -25,7 +25,9 @@ describe('resource fetchAPI', () => {
       url: 'https://example.com',
       allowInsecureSsl: true,
       allowRedirects: true,
+      format: 'raw',
       proxies: true,
+      schema: { foo: 'bar' },
     });
   });
 });