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

* docs: WC-4152 Expose subdomain delete for workers

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 1894
+configured_endpoints: 1895
 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

api.md

@@ -2508,6 +2508,7 @@ Response Types:
 Methods:
 
 - <code title="put /accounts/{account_id}/workers/subdomain">client.Workers.Subdomains.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers#SubdomainService.Update">Update</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, params <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers">workers</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers#SubdomainUpdateParams">SubdomainUpdateParams</a>) (<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers">workers</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers#SubdomainUpdateResponse">SubdomainUpdateResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
+- <code title="delete /accounts/{account_id}/workers/subdomain">client.Workers.Subdomains.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers#SubdomainService.Delete">Delete</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, body <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers">workers</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers#SubdomainDeleteParams">SubdomainDeleteParams</a>) <a href="https://pkg.go.dev/builtin#error">error</a></code>
 - <code title="get /accounts/{account_id}/workers/subdomain">client.Workers.Subdomains.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers#SubdomainService.Get">Get</a>(ctx <a href="https://pkg.go.dev/context">context</a>.<a href="https://pkg.go.dev/context#Context">Context</a>, query <a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers">workers</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers#SubdomainGetParams">SubdomainGetParams</a>) (<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers">workers</a>.<a href="https://pkg.go.dev/github.com/cloudflare/cloudflare-go/v6/workers#SubdomainGetResponse">SubdomainGetResponse</a>, <a href="https://pkg.go.dev/builtin#error">error</a>)</code>
 
 ## Observability

workers/subdomain.go

@@ -51,6 +51,19 @@ func (r *SubdomainService) Update(ctx context.Context, params SubdomainUpdatePar
 	return
 }
 
+// Deletes a Workers subdomain for an account.
+func (r *SubdomainService) Delete(ctx context.Context, body SubdomainDeleteParams, opts ...option.RequestOption) (err error) {
+	opts = slices.Concat(r.Options, opts)
+	opts = append([]option.RequestOption{option.WithHeader("Accept", "")}, opts...)
+	if body.AccountID.Value == "" {
+		err = errors.New("missing required account_id parameter")
+		return
+	}
+	path := fmt.Sprintf("accounts/%s/workers/subdomain", body.AccountID)
+	err = requestconfig.ExecuteNewRequest(ctx, http.MethodDelete, path, nil, nil, opts...)
+	return
+}
+
 // Returns a Workers subdomain for an account.
 func (r *SubdomainService) Get(ctx context.Context, query SubdomainGetParams, opts ...option.RequestOption) (res *SubdomainGetResponse, err error) {
 	var env SubdomainGetResponseEnvelope
@@ -259,6 +272,11 @@ func (r SubdomainUpdateResponseEnvelopeSuccess) IsKnown() bool {
 	return false
 }
 
+type SubdomainDeleteParams struct {
+	// Identifier.
+	AccountID param.Field[string] `path:"account_id,required"`
+}
+
 type SubdomainGetParams struct {
 	// Identifier.
 	AccountID param.Field[string] `path:"account_id,required"`

workers/subdomain_test.go

@@ -40,6 +40,31 @@ func TestSubdomainUpdate(t *testing.T) {
 	}
 }
 
+func TestSubdomainDelete(t *testing.T) {
+	baseURL := "http://localhost:4010"
+	if envURL, ok := os.LookupEnv("TEST_API_BASE_URL"); ok {
+		baseURL = envURL
+	}
+	if !testutil.CheckTestServer(t, baseURL) {
+		return
+	}
+	client := cloudflare.NewClient(
+		option.WithBaseURL(baseURL),
+		option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"),
+		option.WithAPIEmail("user@example.com"),
+	)
+	err := client.Workers.Subdomains.Delete(context.TODO(), workers.SubdomainDeleteParams{
+		AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
+	})
+	if err != nil {
+		var apierr *cloudflare.Error
+		if errors.As(err, &apierr) {
+			t.Log(string(apierr.DumpRequest(true)))
+		}
+		t.Fatalf("err should be nil: %s", err.Error())
+	}
+}
+
 func TestSubdomainGet(t *testing.T) {
 	baseURL := "http://localhost:4010"
 	if envURL, ok := os.LookupEnv("TEST_API_BASE_URL"); ok {