v7.3.0

7.3.0 (2026-05-20)

Full Changelog: v7.2.0...v7.3.0

This release adds several new services and sub-resources across DDoS Protection, AI Security, R2
bucket objects, Workers observability queries, Zero Trust SAML certificates, and more. All changes
are additive -- there are no breaking changes in this release.

---

Features

DDoS Protection (client.DDoSProtection)

• NEW SERVICE: Advanced TCP Protection management for Magic Transit accounts
  • AdvancedTCPProtection.Allowlist -- manage allowlist entries
    • New(), List(), BulkNew(), BulkDelete()
    • Items.Delete(), Items.Edit(), Items.Get()
  • AdvancedTCPProtection.Prefixes -- manage IP prefix configurations
    • New(), List(), BulkNew(), BulkDelete()
    • Items.Delete(), Items.Edit(), Items.Get()
  • AdvancedTCPProtection.SynProtection.Filters -- SYN flood protection filters
    • New(), List(), BulkDelete()
    • Items.Delete(), Items.Edit(), Items.Get()
  • AdvancedTCPProtection.SynProtection.Rules -- SYN flood protection rules
    • New(), List(), BulkDelete()
    • Items.Delete(), Items.Edit(), Items.Get()
  • AdvancedTCPProtection.TCPFlowProtection.Filters -- TCP flow protection filters
    • New(), List(), BulkDelete()
    • Items.Delete(), Items.Edit(), Items.Get()
  • AdvancedTCPProtection.TCPFlowProtection.Rules -- TCP flow protection rules
    • New(), List(), BulkDelete()
    • Items.Delete(), Items.Edit(), Items.Get()
  • AdvancedTCPProtection.Status -- TCP protection status
    • Edit(), Get()

AI Security (client.AISecurity)

• NEW SERVICE: Zone-level AI security settings management
  • Update() -- update AI security settings for a zone
  • Get() -- get current AI security settings
  • CustomTopics.Update() -- update custom topic definitions
  • CustomTopics.Get() -- get custom topic definitions

R2 Bucket Objects (client.R2.Buckets.Objects)

• NEW SUB-RESOURCE: Manage objects within R2 buckets via the control plane API
  • List() -- list objects in a bucket (cursor-paginated)
  • Delete() -- delete a specific object
  • Get() -- download an object (returns *http.Response)
  • Upload() -- upload an object from an io.Reader

Workers Observability Queries (client.Workers.Observability.Queries)

• NEW SUB-RESOURCE: Saved observability queries for Workers telemetry
  • New() -- create a saved query
  • List() -- list saved queries

Workers Secrets Bulk Update (client.Workers.Scripts.Secrets)

• Added BulkUpdate() method -- bulk update secrets for a Worker script via
  PATCH /accounts/{account_id}/workers/scripts/{script_name}/secrets-bulk

Zero Trust - SAML Certificate Management

• Identity Providers (client.ZeroTrust.IdentityProviders.SAMLCertificate)

  • New() -- create a SAML certificate for an identity provider

• Access SAML Certificates (client.ZeroTrust.Access.SAMLCertificates)

  • List() -- list all SAML certificate sets
  • Get() -- get a specific SAML certificate set
  • GetPem() -- download certificate in PEM format (returns *http.Response)
  • Rotate() -- rotate a SAML certificate set

Zero Trust - Resource Library (client.ZeroTrust.ResourceLibrary)

• NEW SUB-RESOURCE: Browse the Zero Trust resource library
  • Applications.List() -- list available applications
  • Applications.Get() -- get application details
  • Categories.List() -- list application categories
  • Categories.Get() -- get category details

Secrets Store (client.SecretsStore.Stores)

• Added Get() method -- retrieve a specific secrets store by ID

AI Search Namespaces (client.AISearch.Namespaces)

• Added namespace-level convenience methods (previously only available at the instance level):
  • Delete() -- delete a namespace
  • ChatCompletions() -- run chat completions against a namespace
  • Read() -- get namespace details
  • Search() -- search within a namespace

---

Other Updates

• Updated generated types and methods across many packages including ai_gateway,
  api_gateway, cache, email_security, intel, load_balancers, logpush,
  radar, secrets_store, workers, workers_for_platforms, workflows, and
  zones

v0.117.0

What's Changed

• Add asset_name to RulesetRuleActionParameters by @jafowler in #4312

Full Changelog: v0.116.0...v0.117.0

v7.2.0

7.2.0 (2026-05-06)

Full Changelog: v7.1.0...v7.2.0

This release adds new sub-resources for AI Gateway billing, Cache Origin Cloud Regions v2, Radar BGP analytics, and Load Balancer monitor group references.

Features

Cache - Origin Cloud Regions v2 (client.Cache.OriginCloudRegions)

• NEW SUB-RESOURCE: Origin Cloud Regions service using the v2 /origin/cloud_regions endpoints
  • Update() -- create or update a cloud region mapping for an origin IP
  • List() -- list all cloud region mappings (paginated)
  • Delete() -- remove a cloud region mapping
  • BulkDelete() -- remove multiple cloud region mappings
  • BulkUpdate() -- create or update multiple cloud region mappings
  • Get() -- get a specific cloud region mapping
  • SupportedRegions() -- list supported cloud regions and vendors

AI Gateway - Billing (client.AIGateway.Billing)

• NEW SUB-RESOURCE: Billing service for AI Gateway accounts
  • CreditBalance() -- get current credit balance
  • UsageHistory() -- get historical usage data
  • InvoiceHistory() -- get past invoices
  • InvoicePreview() -- preview upcoming invoice

AI Gateway - Billing Spending Limit (client.AIGateway.Billing.SpendingLimit)

• NEW SUB-RESOURCE: Manage spending limits for AI Gateway billing
  • New() -- create a spending limit
  • Delete() -- remove a spending limit
  • Get() -- get the current spending limit

AI Gateway - Billing Topup (client.AIGateway.Billing.Topup)

• NEW SUB-RESOURCE: Manage billing top-ups for AI Gateway
  • New() -- create a top-up
  • Status() -- check top-up payment status

AI Gateway - Billing Topup Config (client.AIGateway.Billing.Topup.Config)

• NEW SUB-RESOURCE: Configure automatic top-ups
  • New() -- create a top-up config
  • Delete() -- remove a top-up config
  • Get() -- get the current top-up config

Cache - Smart Tiered Cache (client.Cache.SmartTieredCache)

• Added New() method (POST) to enable smart tiered cache topology

Radar - BGP IP Top (client.Radar.BGP.IPs.Top)

• NEW SUB-RESOURCE: Top ASes by BGP IP announcements
  • Ases() -- get top ASes for BGP IP data

Radar - BGP RPKI ROAs (client.Radar.BGP.RPKI.Roas)

• NEW SUB-RESOURCE: RPKI Route Origin Authorization timeseries
  • Timeseries() -- get ROA timeseries data

Load Balancers - Monitor Group References (client.LoadBalancers.MonitorGroups.References)

• NEW SUB-RESOURCE: Retrieve resources referencing a monitor group
  • Get() -- list references for a monitor group

Bug Fixes

• Codegen: Updated generated types and methods for ai_search, cloudforce_one, resource_sharing, url_scanner, and user packages

v7.1.0

7.1.0 (2026-05-04)

Full Changelog: v7.0.0...v7.1.0

---

Features

Security Center - New Insights Sub-Resources (client.SecurityCenter.Insights)

Three new sub-services added under client.SecurityCenter.Insights:

AuditLogs (client.SecurityCenter.Insights.AuditLogs)

• List(ctx, params) -> *pagination.CursorPagination[InsightAuditLogListResponse]
• ListByInsight(ctx, issueID, params) -> *pagination.CursorPagination[InsightAuditLogListByInsightResponse]

New response types: InsightAuditLogListResponse, InsightAuditLogListByInsightResponse

Classification (client.SecurityCenter.Insights.Classification)

• Update(ctx, issueID, params) -> *InsightClassificationUpdateResponse

New response types: InsightClassificationUpdateResponse

Context (client.SecurityCenter.Insights.Context)

• Get(ctx, issueID, query) -> *InsightContextGetResponse

New response types: InsightContextGetResponse

Zero Trust - Device Deployment Groups (client.ZeroTrust.Devices.DeploymentGroups)

New service client.ZeroTrust.Devices.DeploymentGroups:

• New(ctx, params) -> *DeploymentGroup
• List(ctx, params) -> *pagination.V4PagePaginationArray[DeploymentGroup]
• Delete(ctx, groupID, body) -> *DeviceDeploymentGroupDeleteResponse
• Edit(ctx, groupID, params) -> *DeploymentGroup
• Get(ctx, groupID, query) -> *DeploymentGroup

New response types: DeploymentGroup, DeviceDeploymentGroupDeleteResponse

Queues - Metrics Endpoint (client.Queues)

New method on client.Queues:

• GetMetrics(ctx, queueID, query) -> *QueueGetMetricsResponse

New response types: QueueGetMetricsResponse

Organizations - Audit Logs (client.Organizations.Logs.Audit)

New service client.Organizations.Logs.Audit:

• List(ctx, organizationID, query) -> *pagination.CursorPaginationAfter[LogAuditListResponse]

New response types: LogAuditListResponse

v7.0.0

7.0.0 (2026-04-30)

Full Changelog: v6.10.0...v7.0.0

This is a major version release that includes breaking changes to three packages: ai_search, email_security, and workers. These changes reflect upstream API specification updates that improve type correctness and consistency. Non-breaking features and updates are also included across several other packages.

Please ensure you read through the list of changes below before moving to this version - this will help you understand any down or upstream issues it may cause to your environments.

---

Breaking Changes

See the v7.0.0 Migration Guide for before/after code examples and actions needed for each change.

AI Search - SearchForAgents Metadata Removed

The SearchForAgents nested type has been removed from all instance metadata structs. This field is no longer part of the API specification.

Removed Types:

• InstanceNewResponseMetadataSearchForAgents
• InstanceUpdateResponseMetadataSearchForAgents
• InstanceListResponseMetadataSearchForAgents
• InstanceDeleteResponseMetadataSearchForAgents
• InstanceReadResponseMetadataSearchForAgents
• InstanceNewParamsMetadataSearchForAgents
• InstanceUpdateParamsMetadataSearchForAgents
• NamespaceInstanceNewResponseMetadataSearchForAgents
• NamespaceInstanceUpdateResponseMetadataSearchForAgents
• NamespaceInstanceListResponseMetadataSearchForAgents
• NamespaceInstanceDeleteResponseMetadataSearchForAgents
• NamespaceInstanceReadResponseMetadataSearchForAgents
• NamespaceInstanceNewParamsMetadataSearchForAgents
• NamespaceInstanceUpdateParamsMetadataSearchForAgents

Email Security - Path Parameter Type Changes (int64 to string)

Multiple Email Security settings sub-resources have changed their path parameter types from int64 to string. This affects Delete, Edit, and Get methods across the following services:

• AllowPolicies (policyID int64 -> policyID string)
• BlockSenders (patternID int64 -> patternID string)
• Domains (domainID int64 -> domainID string)
• ImpersonationRegistry (displayNameID int64 -> impersonationRegistryID string)
• TrustedDomains (trustedDomainID int64 -> trustedDomainID string)

Email Security - Investigate Parameter Rename

The Investigate.Get, Investigate.Move.New, and Investigate.Reclassify.New methods now use investigateID instead of postfixID as the path parameter name.

Email Security - Domains BulkDelete Method Removed

The SettingDomainService.BulkDelete method and its associated types have been removed:

• SettingDomainBulkDeleteResponse
• SettingDomainBulkDeleteParams

Email Security - TrustedDomains Return Type Change

SettingTrustedDomainService.New now returns *SettingTrustedDomainNewResponse instead of *SettingTrustedDomainNewResponseUnion.

Email Security - Investigate.Move Return Type Change

InvestigateMoveService.New now returns *pagination.SinglePage[InvestigateMoveNewResponse] instead of *[]InvestigateMoveNewResponse.

Workers - Observability Telemetry Filter Restructuring

The observability telemetry filter parameter types have been restructured to support nested filter groups. New discriminated union types replace the previous flat filter arrays:

• ObservabilityTelemetryKeysParams.Filters now accepts FiltersObjectFilterUnion (was []interface{})
• ObservabilityTelemetryQueryParams.Parameters.Filters now accepts FiltersObjectFilterUnion
• ObservabilityTelemetryValuesParams.Filters now accepts FiltersObjectFilterUnion

New types include FiltersObjectFiltersObject (for group filters with FilterCombination) and FiltersWorkersObservabilityFilterLeaf (for leaf filters with typed Operation, Type, and Value fields).

---

Features

Organizations (client.Organizations)

• NEW SERVICE: client.Organizations.Logs.Audit -- query organization audit logs
  • List() - Retrieve audit logs with cursor-based pagination

Browser Rendering (client.BrowserRendering)

• client.BrowserRendering.Devtools.Browser.Targets.Close() -- close a specific browser target (tab, page) by ID

Queues (client.Queues)

• client.Queues.GetMetrics() -- retrieve queue metrics for a specific queue

AI Search (client.AISearch)

• Added WaitForCompletion parameter to NamespaceInstanceItemNewOrUpdateParams and NamespaceInstanceItemSyncParams for synchronous indexing confirmation

---

Bug Fixes

• Magic Transit: ConnectorService.List parameter name corrected from query to params (non-functional, affects generated documentation only)

v6.10.0

6.10.0 (2026-04-23)

Full Changelog: v6.9.0...v6.10.0

In this release, you'll see a number of breaking changes. This is primarily due to changes in OpenAPI definitions, which our libraries are based off of, and codegen updates that we rely on to read those OpenAPI definitions and produce our SDK libraries.

Please ensure you read through the list of changes below before moving to this version - this will help you understand any down or upstream issues it may cause to your environments.

---

Breaking Changes

See the v6.10.0 Migration Guide for before/after code examples and actions needed for each change.

Abuse Reports - Registrar WHOIS Report Field Removals

Several fields have been removed from AbuseReportNewParamsBodyAbuseReportsRegistrarWhoisReportRegWhoRequest:

• RegWhoGoodFaithAffirmation
• RegWhoLawfulProcessingAgreement
• RegWhoLegalBasis
• RegWhoRequestType
• RegWhoRequestedDataElements

AI Search - Instance Params Restructured

The InstanceNewParams and InstanceUpdateParams types have been significantly restructured. Many fields have been moved or removed:

• InstanceNewParams.TokenID, Type, CreatedFromAISearchWizard, WorkerDomain removed
• InstanceUpdateParams — most configuration fields removed (including IndexMethod, IndexingOptions, MaxNumResults, Metadata, Paused, PublicEndpointParams, Reranking, RerankingModel, RetrievalOptions, RewriteModel, RewriteQuery, ScoreThreshold, SourceParams, Summarization, SummarizationModel, SystemPromptAISearch, SystemPromptIndexSummarization, SystemPromptRewriteQuery, TokenID, CreatedFromAISearchWizard, WorkerDomain)
• InstanceSearchParams.Messages field removed along with InstanceSearchParamsMessage and InstanceSearchParamsMessagesRole types

AI Search - InstanceItem Service Removed

The InstanceItemService type has been removed. The items sub-resource at client.AISearch.Instances.Items no longer exists in the non-namespace path. Use client.AISearch.Namespaces.Instances.Items instead.

AI Search - Token Types Removed

The following types have been removed from the ai_search package:

• TokenDeleteResponse
• TokenListParams (and associated TokenListParamsOrderBy, TokenListParamsOrderByDirection)

Email Security - Investigate Move Return Type Change

The Investigate.Move.New() method now returns a raw slice instead of a paginated wrapper:

• New() returns *[]InvestigateMoveNewResponse instead of *pagination.SinglePage[InvestigateMoveNewResponse]
• NewAutoPaging() method removed

Hyperdrive - Config Params Restructured

The ConfigEditParams type lost its MTLS and Name fields. The HyperdriveMTLSParam type lost MTLS and Host fields. The Host field on origin config changed from param.Field[string] to a plain string.

IAM - UserGroupMember Params and Return Types Changed

The UserGroupMemberNewParams struct has been restructured and the New() method now returns a paginated response:

• UserGroupMemberNewParams.Body renamed to UserGroupMemberNewParams.Members
• UserGroupMemberNewParamsBody renamed to UserGroupMemberNewParamsMember
• UserGroupMemberUpdateParams.Body renamed to UserGroupMemberUpdateParams.Members
• UserGroupMemberUpdateParamsBody renamed to UserGroupMemberUpdateParamsMember
• UserGroups.Members.New() returns *pagination.SinglePage[UserGroupMemberNewResponse] instead of *UserGroupMemberNewResponse

IAM - UserGroup List Direction Type Changed

The UserGroupListParams.Direction field changed from param.Field[string] to param.Field[UserGroupListParamsDirection] (typed enum with asc/desc values).

Pipelines - Delete Methods Now Return Typed Responses

Several delete methods across Pipelines now return typed responses instead of bare error:

• Pipelines.DeleteV1() returns (*PipelineDeleteV1Response, error) instead of error
• Pipelines.Sinks.Delete() returns (*SinkDeleteResponse, error) instead of error
• Pipelines.Streams.Delete() returns (*StreamDeleteResponse, error) instead of error

Queues - Message Response Types Removed

The following response envelope types have been removed:

• MessageBulkPushResponseSuccess
• MessagePushResponseSuccess
• MessageAckResponse fields RetryCount and Warnings removed

Secrets Store - Pagination Wrapper Removal and Type Changes

Methods now return direct types instead of SinglePage wrappers, and several internal types have been removed. Associated AutoPaging methods have also been removed:

• Stores.New() returns *StoreNewResponse instead of *pagination.SinglePage[StoreNewResponse]
• Stores.NewAutoPaging() method removed
• Stores.Secrets.BulkDelete() returns *StoreSecretBulkDeleteResponse instead of *pagination.SinglePage[StoreSecretBulkDeleteResponse]
• Stores.Secrets.BulkDeleteAutoPaging() method removed
• Removed types: StoreDeleteResponse, StoreDeleteResponseEnvelopeResultInfo, StoreSecretDeleteResponse, StoreSecretDeleteResponseStatus, StoreSecretBulkDeleteResponse (old shape), StoreSecretBulkDeleteResponseStatus, StoreSecretDeleteResponseEnvelopeResultInfo
• StoreNewParams restructured (old StoreNewParamsBody removed)
• StoreSecretBulkDeleteParams restructured

Stream - AudioTracks Return Type Change

The AudioTracks.Get() method now returns a dedicated response type instead of a paginated list. The GetAutoPaging() method has been removed:

• Get() returns *AudioTrackGetResponse instead of *pagination.SinglePage[Audio]
• GetAutoPaging() method removed

Stream - Clip Type Removal and Return Type Change

The Clip.New() method now returns the shared Video type. The following types have been entirely removed:

• Clip, ClipPlayback, ClipStatus, ClipWatermark

Stream - Copy and Clip Params Field Removals

• ClipNewParams.MaxDurationSeconds, ThumbnailTimestampPct, Watermark removed
• CopyNewParams.ThumbnailTimestampPct, Watermark removed

Stream - Download and Webhook Changes

• DownloadNewResponseStatus type removed
• WebhookUpdateResponse and WebhookGetResponse changed from interface{} type aliases to full struct types

Zero Trust - Access AI Control MCP Portal Union Types Removed

The following union interface types have been removed:

• AccessAIControlMcpPortalListResponseServersUpdatedPromptsUnion
• AccessAIControlMcpPortalListResponseServersUpdatedToolsUnion
• AccessAIControlMcpPortalReadResponseServersUpdatedPromptsUnion
• AccessAIControlMcpPortalReadResponseServersUpdatedToolsUnion

---

Features

Vulnerability Scanner (client.VulnerabilityScanner)

• NEW SERVICE: Full vulnerability scanning management
  • CredentialSets - CRUD for credential sets (New, Update, List, Delete, Edit, Get)
    • Credentials - Manage credentials within sets (New, Update, List, Delete, Edit, Get)
  • Scans - Create and manage vulnerability scans (New, List, Get)
  • TargetEnvironments - Manage scan target environments (New, Update, List, Delete, Edit, Get)

AI Search - Namespaces (client.AISearch.Namespaces)

• NEW SERVICE: Namespace-scoped AI Search management
  • New(), Update(), List(), Delete(), ChatCompletions(), Read(), Search()
  • Instances - Namespace-scoped instances (New, Update, List, Delete, ChatCompletions, Read, Search, Stats)
    • Jobs - Instance job management (New, Update, List, Get, Logs)
    • Items - Instance item management (List, Delete, Chunks, NewOrUpdate, Download, Get, Logs, Sync, Upload)

Browser Rendering - Devtools (client.BrowserRendering.Devtools)

• NEW SERVICE: DevTools protocol browser control
  • Session - List and get devtools sessions
  • Browser - Browser lifecycle management (New, Delete, Connect, Launch, Protocol, Version)
    • Page - Get page by target ID
    • Targets - Manage browser targets (New, List, Activate, Get)

Registrar (client.Registrar)

• NEW: Domain check and search endpoints
  • Check() - POST /accounts/{account_id}/registrar/domain-check
  • Search() - GET /accounts/{account_id}/registrar/domain-search
• NEW: Registration management (client.Registrar.Registrations)
  • New(), List(), Edit(), Get()
• RegistrationStatus.Get() - Get registration workflow status
• UpdateStatus.Get() - Get update workflow status

Cache - Origin Cloud Regions (client.Cache.OriginCloudRegions)

• NEW SERVICE: Manage origin cloud region configurations
  • New(), List(), Delete(), BulkDelete(), BulkEdit(), Edit(), Get(), SupportedRegions()

Zero Trust - DLP Settings (client.ZeroTrust.DLP.Settings)

• NEW SERVICE: DLP settings management
  • Update(), Delete(), Edit(), Get()

Radar

• AgentReadiness.Summary() - Agent readiness summary by dimension
• AI.MarkdownForAgents.Summary() - Markdown-for-agents summary
• AI.MarkdownForAgents.Timeseries() - Markdown-for-agents timeseries

IAM (client.IAM)

• UserGroups.Members.Get() - Get details of a specific member in a user group
• UserGroups.Members.NewAutoPaging() - Auto-paging variant for adding members
• UserGroups.NewParams.Policies changed from required to optional

Bot Management

• ContentBotsProtection field added to BotFightModeConfiguration and SubscriptionConfiguration (block/disabled)

---

Deprecations

None in this release.

---

Bug Fixes

• Testing: CONTRIBUTING.md updated to reference steady instead of Prism for running tests against OpenAPI specs

v6.9.0

6.9.0 (2026-04-01)

Full Changelog: v6.8.0...v6.9.0

In this release, you'll see a number of breaking changes. This is primarily due to changes in OpenAPI definitions, which our libraries are based off of, and codegen updates that we rely on to read those OpenAPI definitions and produce our SDK libraries.

Please ensure you read through the list of changes below before moving to this version - this will help you understand any down or upstream issues it may cause to your environments.

---

Breaking Changes

See the v6.9.0 Migration Guide for before/after code examples and actions needed for each change.

AI Gateway - AccountID, AccountTag, and InternalID Field Removal

The AccountID, AccountTag, and InternalID fields have been removed from all AI Gateway response types:

• AIGatewayNewResponse
• AIGatewayUpdateResponse
• AIGatewayListResponse
• AIGatewayDeleteResponse
• AIGatewayGetResponse
• DynamicRoutingNewResponse
• DynamicRoutingDeleteResponse
• DynamicRoutingNewDeploymentResponse
• DynamicRoutingNewVersionResponse
• DynamicRoutingGetResponse
• DynamicRoutingGetVersionResponse

AI Search - VectorizeName Field Removal

The VectorizeName field has been removed from all AI Search instance response types:

• InstanceNewResponse.VectorizeName
• InstanceUpdateResponse.VectorizeName
• InstanceListResponse.VectorizeName
• InstanceDeleteResponse.VectorizeName
• InstanceReadResponse.VectorizeName

AI Search - KeywordMatchMode Enum Values Changed

The KeywordMatchMode enum values have been renamed:

• KeywordMatchModeExactMatch → KeywordMatchModeAnd
• KeywordMatchModeFuzzyMatch → KeywordMatchModeOr

Affects InstanceNewParams and InstanceUpdateParams.

Billing - New PayGo Usage Endpoint

NEW: Added billing.Usage service with PayGo endpoint:

• client.Billing.Usage.Paygo() - Returns billable usage data for PayGo (self-serve) accounts

Note: The PayGo endpoint parameters (From, To) are now the primary query mechanism. The previously available LastMonthPeriodStart and LastYearPeriodStart parameters were removed in the underlying API specification.

Connectivity - TCP Service Support

The directory services now support TCP service configurations via discriminated union types:

• ServiceConfig is now a discriminated union of HttpServiceConfig and TcpServiceConfig
• New TcpServiceConfig type with tcp_port and app_protocol fields
• HttpServiceConfig and TcpServiceConfig both extend ServiceCommon base type

Custom Hostnames - Hostname Parameter Type Change

The Hostname parameter in CustomHostnameListParams has changed from a simple string to a structured object:

• Before: Hostname param.Field[string]
• After: Hostname param.Field[CustomHostnameListParamsHostname] (object with Contain field)

AI Search - InstanceItem Service Methods Removed

The InstanceItem service methods have been removed. The service structure still exists at client.AISearch.Instances.Items but no longer provides any methods:

• List() - List indexed items in an AI Search instance
• ListAutoPaging() - Auto-paging list method
• Get() - Get a specific indexed item
• All associated response types (InstanceItemListResponse, InstanceItemGetResponse, etc.)

Workers - Filter Type Changes

The observability telemetry filters have been restructured:

• Filter types changed from QueryFilter[] to FilterNode[] (discriminated union)
• Filters now support nested groups via kind: 'group'
• Affects telemetry endpoints: keys, query, and values

Workers - Domain Service Return Type Changes

The workers.Domain service methods now return specific response types instead of the generic Domain type:

• Update() returns *DomainUpdateResponse instead of *Domain
• List() returns pagination.SinglePage[DomainListResponse] instead of pagination.SinglePage[Domain]
• Delete() now returns (*DomainDeleteResponse, error) instead of just error
• Get() returns *DomainGetResponse instead of *Domain

Zero Trust - NetworkSubnet Response Type Consolidation

The NetworkSubnet service methods now use the shared Subnet type instead of endpoint-specific response types:

• NetworkSubnetService.List() returns Subnet instead of NetworkSubnetListResponse
• NetworkSubnetWARPService.New() returns Subnet instead of NetworkSubnetWARPNewResponse
• NetworkSubnetWARPService.Edit() returns Subnet instead of NetworkSubnetWARPEditResponse
• NetworkSubnetWARPService.Get() returns Subnet instead of NetworkSubnetWARPGetResponse
• NetworkSubnetCloudflareSourceService.Update() returns Subnet instead of NetworkSubnetCloudflareSourceUpdateResponse

The removed types (NetworkSubnetListResponse, NetworkSubnetWARPNewResponse, etc.) have been consolidated into the shared Subnet type.

Zero Trust - MfaBypass Field Removal

The MfaBypass field has been removed from MFA configuration types across multiple services:

Affected Param Types:

• AccessApplicationNewParamsBodySelfHostedApplicationMfaConfig.MfaBypass
• AccessApplicationUpdateParamsBodySelfHostedApplicationMfaConfig.MfaBypass
• AccessApplicationPolicyNewParamsMfaConfig.MfaBypass
• AccessApplicationPolicyUpdateParamsMfaConfig.MfaBypass
• AccessApplicationPolicyTestNewParamsPoliciesObjectMfaConfig.MfaBypass
• AccessPolicyNewParamsMfaConfig.MfaBypass
• AccessPolicyUpdateParamsMfaConfig.MfaBypass

Affected Response Types:

• All corresponding MfaConfig response types

Zero Trust - MfaConfigurationAllowed Field Removal

The MfaConfigurationAllowed field has been removed from Organization types:

• OrganizationNewParams.MfaConfigurationAllowed
• OrganizationUpdateParams.MfaConfigurationAllowed
• OrganizationNewResponse.MfaConfigurationAllowed

---

Features

AI Search - BoostBy Field Addition

The BoostBy field has been added to retrieval options across multiple response types:

• InstanceNewResponseRetrievalOptions.BoostBy
• InstanceUpdateResponseRetrievalOptions.BoostBy
• InstanceListResponseRetrievalOptions.BoostBy
• InstanceDeleteResponseRetrievalOptions.BoostBy
• InstanceReadResponseRetrievalOptions.BoostBy

Browser Rendering (client.browserRendering)

• Crawl: New endpoints for headless browser crawling
  • Create() - Start a crawl job
  • List() - List crawl jobs
  • Get() - Get crawl job details
  • Update() - Update crawl job
  • Delete() - Delete crawl job
  • Screenshot() - Take screenshots during crawl
  • Scrape() - Scrape content during crawl

Brand Protection v2 (client.brandProtection.v2)

• New v2 API endpoints:
  • Logo - Logo management
  • LogoMatch - Logo matching
  • Match - Brand protection matching
  • Query - Query brand protection data

Google Tag Gateway (client.googleTagGateway)

• NEW SERVICE: Manage Google Tag configurations
  • Config.Create(), Update(), List(), Delete(), Get()

Resource Tagging (client.resourceTagging)

• NEW SERVICE: Resource tagging management
  • AccountTag management
  • Key management for resource tagging

Zero Trust Device IP Profiles (client.zeroTrust.devices.ipProfiles)

• IP profile management for device posture
  • Create(), Update(), List(), Delete(), Get()

Abuse Reports

• Mitigation responses now include additional metadata fields

Accounts

• managed_by field with parent_org_id, parent_org_name support

AI Gateway

• zdr field added to all responses and params
• Dataset, evaluation, log, and provider config endpoints updated

AI Search

• Instance management expanded with new fields
• Job management enhancements
• Token management updates

API Gateway

• Configuration and user schema updates
• Expression template fallthrough improvements

D1

• Database query and raw query parameter refinements
• Time travel support: GetBookmark(), Restore()

DNS

• dns_records/usage endpoints added
• Record type improvements

Email Security

• Enhanced investigation endpoints
• New fields: envelope_from, envelope_to, postfix_id_outbound, replyto
• New detection classification: outbound_ndr

Logpush

• New datasets: dex_application_tests, dex_device_state_events, ipsec_logs, warp_config_changes, warp_toggle_changes

Magic Transit

• App and connector enhancements
• CF interconnect improvements
• License key and provisioning support

Organizations

• Organization account management improvements
• Hierarchical organization support

R2

• Super Slurper job enhancements
• Job log improvements

Rulesets

• Buffering fields: request_body_buffering, response_body_buffering

Workers

• Subdomain deletion support
• Script observability settings
• Tags and tail consumers support

Workflows

• Instance retention configuration
• New status option: restart

Zero Trust

• MCP portal and server configuration updates
• Access application type enhancements
• Gateway proxy endpoint improvements
• Tunnel connection updates

---

Deprecations

None in this release.

---

Bug Fixes

• AI Search: Fixed test compatibility issues
• Billing: Transport error handling improvements
• Client: Retry logic error passing fixes

v6.8.0

6.8.0 (2026-02-27)

Full Changelog: v6.7.0...v6.8.0

Breaking Changes

See the v6.8.0 Migration Guide for before/after code examples and actions needed for each change.

• CloudforceOne.ThreatEvents — Delete() method removed
• SSL.CertificatePacks — List() pagination type changed from SinglePage to V4PagePaginationArray
• ZeroTrust.DLP.Datasets — New(), Update(), Get() return types replaced with shared DLP types
• ZeroTrust.DLP.Datasets.Upload — New(), Edit() return types replaced with shared DLP types
• ZeroTrust.DLP.Profiles — Get() return type replaced with shared Profile type
• ZeroTrust.DLP.Profiles.Custom — New(), Update(), Get() return types replaced with shared Profile type
• ZeroTrust.DLP.Profiles.Predefined — Update(), Get() return types replaced with shared PredefinedProfile type

Features

New API Resources

• ACM.CustomTrustStore - Manage custom origin trust store certificates per zone
• EmailSecurity.Phishguard.Reports - List phishing reports via Email Security Phishguard
• Radar.PostQuantum - Post-quantum encryption analytics including origin adoption (Origin.Summary, Origin.TimeseriesGroups) and TLS support (TLS.Support)
• ZeroTrust.Access.Users - Manage Zero Trust Access user identities
• ZeroTrust.DEX.Rules - Manage DEX rules for device testing
• ZeroTrust.Gateway.Pacfiles - Manage Gateway PAC file configurations
• ZeroTrust.Networks.Subnets.WARP - Manage WARP subnet exclusions

New Endpoints (Existing Resources)

Radar.Entities.ASNs

• BotnetThreatFeed() - Retrieve botnet threat feed data for ASNs from Cloudflare Radar

v6.7.0

6.7.0 (2026-02-10)

Full Changelog: v6.6.0...v6.7.0

Features

• fraud: add new fraud detection API package
• ai_gateway: add dynamic routing endpoints for AI Gateway
• ai_gateway: add provider configuration management
• ai_search: add chat completions endpoint
• ai_search: add search endpoint
• ai_search: add custom metadata field support
• ai_search: add specific sitemaps configuration for web crawler
• acm: add Update method for Total TLS settings (upsert pattern)
• images: add metadata filtering support for image listings with operators (eq, in) and nested fields
• magic_transit: add bond_id field to site LAN configuration
• cloudforce_one: add cursor-based pagination for threat events (for deep pagination beyond 100k records)
• cloudforce_one: add includeCreatedEvents option to bulk threat event creation
• cloudforce_one: add datasetId field to threat event responses
• zero_trust: add secure_web_gateway field to MCP portal configuration
• email_security: add ids field for bulk move operations (replaces postfix_ids)

Bug Fixes

• acm: rename New method to Edit for Total TLS settings to match API semantics
• ai: add missing string union variants for AI run response types
• ai: correct ToMarkdown transform method signature to use params instead of separate file parameter
• custom_certificates: make bundle_method and other fields optional in response
• custom_certificates: restructure edit params with proper union types
• kv: change value field to support binary data in namespace value updates
• d1: mark batch field as required for multiple queries
• email_security: update bulk move documentation to specify 100 message limit
• origin_tls_client_auth: restructure to use proper subresource pattern
• workflows: properly type timeout and delay fields as unions (string or number)
• workers: correct Mode types
• browser_rendering: correct test URLs
• cloudforce_one: remove preserveUuid parameter (replaced by includeCreatedEvents)
• cloudforce_one: remove uuid field from threat event creation parameters
• radar: correct CT data source constant name casing

Chores

• intel: remove deprecated IP list endpoint and associated types
• update version to 6.7.0
• tests: skip problematic AI ToMarkdown transform tests
• api: extensive API specification updates across all packages

v6.6.0

6.6.0 (2025-01-15)

Full Changelog: v6.5.0...v6.6.0

Breaking Changes

• browser_rendering: refactor request body parameters to use proper union types

  The models were updated to be accurate to what the API expects, so there are parameter changes
  across most of the sub-resources under the browser_rendering umbrella.

Features

• ai_search: add hybrid search and public endpoint support
• ai_gateway: add is_default field to gateway configurations
• cloudforce_one: add UUID support, STIX2 format, and async indicator processing
• custom_pages: add waf_challenge identifier support
• email_security: add async polling support with Location header and success field
• magic_cloud_networking: expand type definitions for catalog sync, cloud integration, and onramp
• realtime_kit: add comprehensive meeting, preset, recording, session, and webhook endpoints
• rulesets: add request and response body buffering configuration options
• stream: add properly typed download responses with status tracking
• workers: add targeted placement support with host, hostname, and region options
• workers_for_platforms: enhance dispatch namespace script settings types
• workflows: add properly typed instance_retention parameter with error and success retention
• zones: refactor subscription responses to use dedicated types

Chores

• addressing: add auto_generated field to LOA document responses
• custom_hostnames: make SSL parameter optional in create requests
• email_security: deprecate item_count field in move responses
• hyperdrive: improve documentation for caching and port configuration
• pages: refactor project and deployment type definitions
• shared: add union type implementations and documentation updates
• zero_trust: simplify DLP shared entry types by removing entry_type unions