chore(api): mark some methods as deprecated

Author: stainless-app[bot]

addressing/prefixadvertisementstatus.go

@@ -38,6 +38,8 @@ func NewPrefixAdvertisementStatusService(opts ...option.RequestOption) (r *Prefi
 //
 // **Deprecated:** Prefer the BGP Prefixes endpoints, which additionally allow for
 // advertising and withdrawing subnets of an IP prefix.
+//
+// Deprecated: deprecated
 func (r *PrefixAdvertisementStatusService) Edit(ctx context.Context, prefixID string, params PrefixAdvertisementStatusEditParams, opts ...option.RequestOption) (res *PrefixAdvertisementStatusEditResponse, err error) {
 	var env PrefixAdvertisementStatusEditResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -62,6 +64,8 @@ func (r *PrefixAdvertisementStatusService) Edit(ctx context.Context, prefixID st
 //
 // **Deprecated:** Prefer the BGP Prefixes endpoints, which additionally allow for
 // advertising and withdrawing subnets of an IP prefix.
+//
+// Deprecated: deprecated
 func (r *PrefixAdvertisementStatusService) Get(ctx context.Context, prefixID string, query PrefixAdvertisementStatusGetParams, opts ...option.RequestOption) (res *PrefixAdvertisementStatusGetResponse, err error) {
 	var env PrefixAdvertisementStatusGetResponseEnvelope
 	opts = append(r.Options[:], opts...)

billing/profile.go

@@ -36,6 +36,8 @@ func NewProfileService(opts ...option.RequestOption) (r *ProfileService) {
 }
 
 // Gets the current billing profile for the account.
+//
+// Deprecated: deprecated
 func (r *ProfileService) Get(ctx context.Context, query ProfileGetParams, opts ...option.RequestOption) (res *ProfileGetResponse, err error) {
 	var env ProfileGetResponseEnvelope
 	opts = append(r.Options[:], opts...)

email_routing/emailrouting.go

@@ -42,6 +42,8 @@ func NewEmailRoutingService(opts ...option.RequestOption) (r *EmailRoutingServic
 
 // Disable your Email Routing zone. Also removes additional MX records previously
 // required for Email Routing to work.
+//
+// Deprecated: deprecated
 func (r *EmailRoutingService) Disable(ctx context.Context, params EmailRoutingDisableParams, opts ...option.RequestOption) (res *Settings, err error) {
 	var env EmailRoutingDisableResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -59,6 +61,8 @@ func (r *EmailRoutingService) Disable(ctx context.Context, params EmailRoutingDi
 }
 
 // Enable you Email Routing zone. Add and lock the necessary MX and SPF records.
+//
+// Deprecated: deprecated
 func (r *EmailRoutingService) Enable(ctx context.Context, params EmailRoutingEnableParams, opts ...option.RequestOption) (res *Settings, err error) {
 	var env EmailRoutingEnableResponseEnvelope
 	opts = append(r.Options[:], opts...)

firewall/wafoverride.go

@@ -41,6 +41,8 @@ func NewWAFOverrideService(opts ...option.RequestOption) (r *WAFOverrideService)
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFOverrideService) New(ctx context.Context, params WAFOverrideNewParams, opts ...option.RequestOption) (res *Override, err error) {
 	var env WAFOverrideNewResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -61,6 +63,8 @@ func (r *WAFOverrideService) New(ctx context.Context, params WAFOverrideNewParam
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFOverrideService) Update(ctx context.Context, overridesID string, params WAFOverrideUpdateParams, opts ...option.RequestOption) (res *Override, err error) {
 	var env WAFOverrideUpdateResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -85,6 +89,8 @@ func (r *WAFOverrideService) Update(ctx context.Context, overridesID string, par
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFOverrideService) List(ctx context.Context, params WAFOverrideListParams, opts ...option.RequestOption) (res *pagination.V4PagePaginationArray[Override], err error) {
 	var raw *http.Response
 	opts = append(r.Options[:], opts...)
@@ -110,6 +116,8 @@ func (r *WAFOverrideService) List(ctx context.Context, params WAFOverrideListPar
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFOverrideService) ListAutoPaging(ctx context.Context, params WAFOverrideListParams, opts ...option.RequestOption) *pagination.V4PagePaginationArrayAutoPager[Override] {
 	return pagination.NewV4PagePaginationArrayAutoPager(r.List(ctx, params, opts...))
 }
@@ -118,6 +126,8 @@ func (r *WAFOverrideService) ListAutoPaging(ctx context.Context, params WAFOverr
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFOverrideService) Delete(ctx context.Context, overridesID string, body WAFOverrideDeleteParams, opts ...option.RequestOption) (res *WAFOverrideDeleteResponse, err error) {
 	var env WAFOverrideDeleteResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -142,6 +152,8 @@ func (r *WAFOverrideService) Delete(ctx context.Context, overridesID string, bod
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFOverrideService) Get(ctx context.Context, overridesID string, query WAFOverrideGetParams, opts ...option.RequestOption) (res *Override, err error) {
 	var env WAFOverrideGetResponseEnvelope
 	opts = append(r.Options[:], opts...)

firewall/wafpackage.go

@@ -47,6 +47,8 @@ func NewWAFPackageService(opts ...option.RequestOption) (r *WAFPackageService) {
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageService) List(ctx context.Context, params WAFPackageListParams, opts ...option.RequestOption) (res *pagination.V4PagePaginationArray[WAFPackageListResponse], err error) {
 	var raw *http.Response
 	opts = append(r.Options[:], opts...)
@@ -72,6 +74,8 @@ func (r *WAFPackageService) List(ctx context.Context, params WAFPackageListParam
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageService) ListAutoPaging(ctx context.Context, params WAFPackageListParams, opts ...option.RequestOption) *pagination.V4PagePaginationArrayAutoPager[WAFPackageListResponse] {
 	return pagination.NewV4PagePaginationArrayAutoPager(r.List(ctx, params, opts...))
 }
@@ -80,6 +84,8 @@ func (r *WAFPackageService) ListAutoPaging(ctx context.Context, params WAFPackag
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageService) Get(ctx context.Context, packageID string, query WAFPackageGetParams, opts ...option.RequestOption) (res *WAFPackageGetResponse, err error) {
 	opts = append(r.Options[:], opts...)
 	if query.ZoneID.Value == "" {

firewall/wafpackagegroup.go

@@ -41,6 +41,8 @@ func NewWAFPackageGroupService(opts ...option.RequestOption) (r *WAFPackageGroup
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageGroupService) List(ctx context.Context, packageID string, params WAFPackageGroupListParams, opts ...option.RequestOption) (res *pagination.V4PagePaginationArray[Group], err error) {
 	var raw *http.Response
 	opts = append(r.Options[:], opts...)
@@ -70,6 +72,8 @@ func (r *WAFPackageGroupService) List(ctx context.Context, packageID string, par
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageGroupService) ListAutoPaging(ctx context.Context, packageID string, params WAFPackageGroupListParams, opts ...option.RequestOption) *pagination.V4PagePaginationArrayAutoPager[Group] {
 	return pagination.NewV4PagePaginationArrayAutoPager(r.List(ctx, packageID, params, opts...))
 }
@@ -79,6 +83,8 @@ func (r *WAFPackageGroupService) ListAutoPaging(ctx context.Context, packageID s
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageGroupService) Edit(ctx context.Context, packageID string, groupID string, params WAFPackageGroupEditParams, opts ...option.RequestOption) (res *interface{}, err error) {
 	var env WAFPackageGroupEditResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -107,6 +113,8 @@ func (r *WAFPackageGroupService) Edit(ctx context.Context, packageID string, gro
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageGroupService) Get(ctx context.Context, packageID string, groupID string, query WAFPackageGroupGetParams, opts ...option.RequestOption) (res *interface{}, err error) {
 	var env WAFPackageGroupGetResponseEnvelope
 	opts = append(r.Options[:], opts...)

firewall/wafpackagerule.go

@@ -43,6 +43,8 @@ func NewWAFPackageRuleService(opts ...option.RequestOption) (r *WAFPackageRuleSe
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageRuleService) List(ctx context.Context, packageID string, params WAFPackageRuleListParams, opts ...option.RequestOption) (res *pagination.V4PagePaginationArray[WAFPackageRuleListResponse], err error) {
 	var raw *http.Response
 	opts = append(r.Options[:], opts...)
@@ -72,6 +74,8 @@ func (r *WAFPackageRuleService) List(ctx context.Context, packageID string, para
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageRuleService) ListAutoPaging(ctx context.Context, packageID string, params WAFPackageRuleListParams, opts ...option.RequestOption) *pagination.V4PagePaginationArrayAutoPager[WAFPackageRuleListResponse] {
 	return pagination.NewV4PagePaginationArrayAutoPager(r.List(ctx, packageID, params, opts...))
 }
@@ -80,6 +84,8 @@ func (r *WAFPackageRuleService) ListAutoPaging(ctx context.Context, packageID st
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageRuleService) Edit(ctx context.Context, packageID string, ruleID string, params WAFPackageRuleEditParams, opts ...option.RequestOption) (res *WAFPackageRuleEditResponse, err error) {
 	var env WAFPackageRuleEditResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -108,6 +114,8 @@ func (r *WAFPackageRuleService) Edit(ctx context.Context, packageID string, rule
 //
 // **Note:** Applies only to the
 // [previous version of WAF managed rules](https://developers.cloudflare.com/support/firewall/managed-rules-web-application-firewall-waf/understanding-waf-managed-rules-web-application-firewall/).
+//
+// Deprecated: deprecated
 func (r *WAFPackageRuleService) Get(ctx context.Context, packageID string, ruleID string, query WAFPackageRuleGetParams, opts ...option.RequestOption) (res *interface{}, err error) {
 	var env WAFPackageRuleGetResponseEnvelope
 	opts = append(r.Options[:], opts...)

images/v1.go

@@ -70,6 +70,8 @@ func (r *V1Service) New(ctx context.Context, params V1NewParams, opts ...option.
 
 // List up to 100 images with one request. Use the optional parameters below to get
 // a specific range of images.
+//
+// Deprecated: deprecated
 func (r *V1Service) List(ctx context.Context, params V1ListParams, opts ...option.RequestOption) (res *pagination.V4PagePagination[V1ListResponse], err error) {
 	var raw *http.Response
 	opts = append(r.Options[:], opts...)
@@ -93,6 +95,8 @@ func (r *V1Service) List(ctx context.Context, params V1ListParams, opts ...optio
 
 // List up to 100 images with one request. Use the optional parameters below to get
 // a specific range of images.
+//
+// Deprecated: deprecated
 func (r *V1Service) ListAutoPaging(ctx context.Context, params V1ListParams, opts ...option.RequestOption) *pagination.V4PagePaginationAutoPager[V1ListResponse] {
 	return pagination.NewV4PagePaginationAutoPager(r.List(ctx, params, opts...))
 }

intel/attacksurfacereportissue.go

@@ -38,6 +38,8 @@ func NewAttackSurfaceReportIssueService(opts ...option.RequestOption) (r *Attack
 }
 
 // Get Security Center Issues
+//
+// Deprecated: deprecated
 func (r *AttackSurfaceReportIssueService) List(ctx context.Context, params AttackSurfaceReportIssueListParams, opts ...option.RequestOption) (res *pagination.V4PagePagination[AttackSurfaceReportIssueListResponse], err error) {
 	var raw *http.Response
 	opts = append(r.Options[:], opts...)
@@ -60,11 +62,15 @@ func (r *AttackSurfaceReportIssueService) List(ctx context.Context, params Attac
 }
 
 // Get Security Center Issues
+//
+// Deprecated: deprecated
 func (r *AttackSurfaceReportIssueService) ListAutoPaging(ctx context.Context, params AttackSurfaceReportIssueListParams, opts ...option.RequestOption) *pagination.V4PagePaginationAutoPager[AttackSurfaceReportIssueListResponse] {
 	return pagination.NewV4PagePaginationAutoPager(r.List(ctx, params, opts...))
 }
 
 // Get Security Center Issue Counts by Class
+//
+// Deprecated: deprecated
 func (r *AttackSurfaceReportIssueService) Class(ctx context.Context, params AttackSurfaceReportIssueClassParams, opts ...option.RequestOption) (res *[]AttackSurfaceReportIssueClassResponse, err error) {
 	var env AttackSurfaceReportIssueClassResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -82,6 +88,8 @@ func (r *AttackSurfaceReportIssueService) Class(ctx context.Context, params Atta
 }
 
 // Archive Security Center Insight
+//
+// Deprecated: deprecated
 func (r *AttackSurfaceReportIssueService) Dismiss(ctx context.Context, issueID string, params AttackSurfaceReportIssueDismissParams, opts ...option.RequestOption) (res *AttackSurfaceReportIssueDismissResponse, err error) {
 	opts = append(r.Options[:], opts...)
 	if params.AccountID.Value == "" {
@@ -98,6 +106,8 @@ func (r *AttackSurfaceReportIssueService) Dismiss(ctx context.Context, issueID s
 }
 
 // Get Security Center Issue Counts by Severity
+//
+// Deprecated: deprecated
 func (r *AttackSurfaceReportIssueService) Severity(ctx context.Context, params AttackSurfaceReportIssueSeverityParams, opts ...option.RequestOption) (res *[]AttackSurfaceReportIssueSeverityResponse, err error) {
 	var env AttackSurfaceReportIssueSeverityResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -115,6 +125,8 @@ func (r *AttackSurfaceReportIssueService) Severity(ctx context.Context, params A
 }
 
 // Get Security Center Issue Counts by Type
+//
+// Deprecated: deprecated
 func (r *AttackSurfaceReportIssueService) Type(ctx context.Context, params AttackSurfaceReportIssueTypeParams, opts ...option.RequestOption) (res *[]AttackSurfaceReportIssueTypeResponse, err error) {
 	var env AttackSurfaceReportIssueTypeResponseEnvelope
 	opts = append(r.Options[:], opts...)

radar/attacklayer3top.go

@@ -54,6 +54,8 @@ func (r *AttackLayer3TopService) Attacks(ctx context.Context, query AttackLayer3
 
 // This endpoint is deprecated. To continue getting this data, switch to the
 // summary by industry endpoint.
+//
+// Deprecated: deprecated
 func (r *AttackLayer3TopService) Industry(ctx context.Context, query AttackLayer3TopIndustryParams, opts ...option.RequestOption) (res *AttackLayer3TopIndustryResponse, err error) {
 	var env AttackLayer3TopIndustryResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -68,6 +70,8 @@ func (r *AttackLayer3TopService) Industry(ctx context.Context, query AttackLayer
 
 // This endpoint is deprecated. To continue getting this data, switch to the
 // summary by vertical endpoint.
+//
+// Deprecated: deprecated
 func (r *AttackLayer3TopService) Vertical(ctx context.Context, query AttackLayer3TopVerticalParams, opts ...option.RequestOption) (res *AttackLayer3TopVerticalResponse, err error) {
 	var env AttackLayer3TopVerticalResponseEnvelope
 	opts = append(r.Options[:], opts...)

radar/attacklayer7top.go

@@ -57,6 +57,8 @@ func (r *AttackLayer7TopService) Attacks(ctx context.Context, query AttackLayer7
 
 // This endpoint is deprecated. To continue getting this data, switch to the
 // summary by industry endpoint.
+//
+// Deprecated: deprecated
 func (r *AttackLayer7TopService) Industry(ctx context.Context, query AttackLayer7TopIndustryParams, opts ...option.RequestOption) (res *AttackLayer7TopIndustryResponse, err error) {
 	var env AttackLayer7TopIndustryResponseEnvelope
 	opts = append(r.Options[:], opts...)
@@ -71,6 +73,8 @@ func (r *AttackLayer7TopService) Industry(ctx context.Context, query AttackLayer
 
 // This endpoint is deprecated. To continue getting this data, switch to the
 // summary by vertical endpoint.
+//
+// Deprecated: deprecated
 func (r *AttackLayer7TopService) Vertical(ctx context.Context, query AttackLayer7TopVerticalParams, opts ...option.RequestOption) (res *AttackLayer7TopVerticalResponse, err error) {
 	var env AttackLayer7TopVerticalResponseEnvelope
 	opts = append(r.Options[:], opts...)

user/billinghistory.go

@@ -36,6 +36,8 @@ func NewBillingHistoryService(opts ...option.RequestOption) (r *BillingHistorySe
 }
 
 // Accesses your billing history object.
+//
+// Deprecated: deprecated
 func (r *BillingHistoryService) List(ctx context.Context, query BillingHistoryListParams, opts ...option.RequestOption) (res *pagination.V4PagePaginationArray[BillingHistory], err error) {
 	var raw *http.Response
 	opts = append(r.Options[:], opts...)
@@ -54,6 +56,8 @@ func (r *BillingHistoryService) List(ctx context.Context, query BillingHistoryLi
 }
 
 // Accesses your billing history object.
+//
+// Deprecated: deprecated
 func (r *BillingHistoryService) ListAutoPaging(ctx context.Context, query BillingHistoryListParams, opts ...option.RequestOption) *pagination.V4PagePaginationArrayAutoPager[BillingHistory] {
 	return pagination.NewV4PagePaginationArrayAutoPager(r.List(ctx, query, opts...))
 }

user/billingprofile.go

@@ -33,6 +33,8 @@ func NewBillingProfileService(opts ...option.RequestOption) (r *BillingProfileSe
 }
 
 // Accesses your billing profile object.
+//
+// Deprecated: deprecated
 func (r *BillingProfileService) Get(ctx context.Context, opts ...option.RequestOption) (res *BillingProfileGetResponse, err error) {
 	var env BillingProfileGetResponseEnvelope
 	opts = append(r.Options[:], opts...)