feat: docs: WC-4152 Expose subdomain delete for workers

stainless-app[bot] · stainless-app[bot] · commit 4f7cc1f2b886 · 2026-01-07T17:23:45.000Z
* docs: WC-4152 Expose subdomain delete for workers
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 1886
+configured_endpoints: 1887
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cloudflare%2Fcloudflare-ffb103f5eee9b32861f01358666cd5ca83d8c5b17eb87398652b6b1512a4a830.yml
 openapi_spec_hash: 748e21d73949bb766db229a1c3ecf8ce
-config_hash: feb968146b5a84697390fed70d260f68
+config_hash: da15c53ae7de30af9d9aa523b32f6559
diff --git a/api.md b/api.md
@@ -2280,6 +2280,7 @@ Types:
 Methods:
 
 - <code title="put /accounts/{account_id}/workers/subdomain">client.workers.subdomains.<a href="./src/resources/workers/subdomains.ts">update</a>({ ...params }) -> SubdomainUpdateResponse</code>
+- <code title="delete /accounts/{account_id}/workers/subdomain">client.workers.subdomains.<a href="./src/resources/workers/subdomains.ts">delete</a>({ ...params }) -> void</code>
 - <code title="get /accounts/{account_id}/workers/subdomain">client.workers.subdomains.<a href="./src/resources/workers/subdomains.ts">get</a>({ ...params }) -> SubdomainGetResponse</code>
 
 ## Observability
diff --git a/src/resources/workers/index.ts b/src/resources/workers/index.ts
@@ -54,6 +54,7 @@ export {
   type SubdomainUpdateResponse,
   type SubdomainGetResponse,
   type SubdomainUpdateParams,
+  type SubdomainDeleteParams,
   type SubdomainGetParams,
 } from './subdomains';
 export { Workers } from './workers';
diff --git a/src/resources/workers/subdomains.ts b/src/resources/workers/subdomains.ts
@@ -27,6 +27,24 @@ export class Subdomains extends APIResource {
     )._thenUnwrap((obj) => obj.result);
   }
 
+  /**
+   * Deletes a Workers subdomain for an account.
+   *
+   * @example
+   * ```ts
+   * await client.workers.subdomains.delete({
+   *   account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+   * });
+   * ```
+   */
+  delete(params: SubdomainDeleteParams, options?: Core.RequestOptions): Core.APIPromise<void> {
+    const { account_id } = params;
+    return this._client.delete(`/accounts/${account_id}/workers/subdomain`, {
+      ...options,
+      headers: { Accept: '*/*', ...options?.headers },
+    });
+  }
+
   /**
    * Returns a Workers subdomain for an account.
    *
@@ -67,6 +85,13 @@ export interface SubdomainUpdateParams {
   subdomain: string;
 }
 
+export interface SubdomainDeleteParams {
+  /**
+   * Identifier.
+   */
+  account_id: string;
+}
+
 export interface SubdomainGetParams {
   /**
    * Identifier.
@@ -79,6 +104,7 @@ export declare namespace Subdomains {
     type SubdomainUpdateResponse as SubdomainUpdateResponse,
     type SubdomainGetResponse as SubdomainGetResponse,
     type SubdomainUpdateParams as SubdomainUpdateParams,
+    type SubdomainDeleteParams as SubdomainDeleteParams,
     type SubdomainGetParams as SubdomainGetParams,
   };
 }
diff --git a/src/resources/workers/workers.ts b/src/resources/workers/workers.ts
@@ -36,6 +36,7 @@ import {
 } from './routes';
 import * as SubdomainsAPI from './subdomains';
 import {
+  SubdomainDeleteParams,
   SubdomainGetParams,
   SubdomainGetResponse,
   SubdomainUpdateParams,
@@ -300,6 +301,7 @@ export declare namespace Workers {
     type SubdomainUpdateResponse as SubdomainUpdateResponse,
     type SubdomainGetResponse as SubdomainGetResponse,
     type SubdomainUpdateParams as SubdomainUpdateParams,
+    type SubdomainDeleteParams as SubdomainDeleteParams,
     type SubdomainGetParams as SubdomainGetParams,
   };
 
diff --git a/tests/api-resources/workers/subdomains.test.ts b/tests/api-resources/workers/subdomains.test.ts
@@ -31,6 +31,25 @@ describe('resource subdomains', () => {
     });
   });
 
+  test('delete: only required params', async () => {
+    const responsePromise = client.workers.subdomains.delete({
+      account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+    });
+    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);
+  });
+
+  test('delete: required and optional params', async () => {
+    const response = await client.workers.subdomains.delete({
+      account_id: '023e105f4ecef8ad9ca31a8372d0c353',
+    });
+  });
+
   test('get: only required params', async () => {
     const responsePromise = client.workers.subdomains.get({ account_id: '023e105f4ecef8ad9ca31a8372d0c353' });
     const rawResponse = await responsePromise.asResponse();
